المصادقة

كل طلب لازم يكون معاه مفتاح API للمتجر. المفتاح بيحدد أنهي متجر هتوصله وإيه المسموح تعمله فيه (الصلاحيات).

#هات مفتاح

1. صاحب المتجر يدخل لوحة تحكم المتاجر.
2. يفتح النطاقات والتطبيقات ← الـ API العام.
3. يدوس اعمل المفتاح، يسمّيه، يختار صلاحياته، ورابط ويب هوك لو حابب.
4. المفتاح بيظهر مرة واحدة. انسخه ساعتها؛ مش هيظهر تاني (لو ضاع اعمل غيره).

المتجر يقدر يكون عنده لحد 10 مفاتيح شغالة. إلغاء المفتاح بيوقف أي طلب بيه فورًا.

#ابعت المفتاح

في هيدر Api-Key:

Api-Key: YOUR_API_KEY

وAuthorization: Bearer YOUR_API_KEY شغالة بنفس الطريقة.

curl https://elmatajer.com/api/v1/vendor/products \
  -H "Api-Key: YOUR_API_KEY" \
  -H "Accept: application/json"

#حافظ عليه

• استخدم المفتاح على سيرفرك بس — مش في المتصفح ولا جوه تطبيق موبايل ولا في repo عام.
• كل شريك ياخد مفتاح لوحده بالصلاحيات اللي محتاجها بس.
• لو المفتاح اتسرّب، الغيه من اللوحة واعمل غيره.

مفتاح ناقص أو ملغي بيرجّع 401؛ ومفتاح من غير الصلاحية المطلوبة بيرجّع 403 وcode: insufficient_scope.