مفاتيح API
من الإعدادات › واجهة API وخطافات الويب أنشئ مفتاحًا وسمِّه، مثل «المتجر الإلكتروني». يظهر المفتاح مرة واحدة: انسخه إلى نظامك. لا نحتفظ إلا ببصمته، فالمفتاح المفقود يُلغى ويُستبدل ولا يُسترجع. وتعرض القائمة آخر استخدام لكل مفتاح.
ما تفعله الواجهة
- POST /orders ينشئ طلب توصيل (الاسم والجوال والمدينة مطلوبة، وحقول العنوان الوطني والدفع عند الاستلام اختيارية).
- GET /orders يسرد أحدث الطلبات حسب التاريخ أو الحالة.
- GET /orders/{reference} يعيد طلبًا واحدًا بحالته ورابط تتبعه.
اطّلع على دليل المطوّرين لمعرفة الحقول والأمثلة.
خطافات الويب
أضف عنوان https خاصًا بك واختر الأحداث: إنشاء الطلب، والخروج للتوصيل، والتسليم، وتعذّر التسليم، وإلغاء الطلب. يحمل كل استدعاء توقيعًا تتحقق منه بسرّ خطاف الويب. ويُعاد الاستدعاء الفاشل بعد 1 و5 و30 و120 و360 دقيقة، وبعد 20 عملية فاشلة متتالية يُوقف الخطاف حتى تصلحه. أرسل تجربة من الشاشة نفسها واقرأ كل عملية إرسال في سجله.
آمن من الأساس
لا يرى هذه الشاشة إلا من يملك دوره صلاحية إدارة مفاتيح API وخطافات الويب. وتُرفض عناوين الشبكات الخاصة.
