GROperator

جارٍ التحميل…

English

سجل التغييرات

الإصدار الأول من واجهة LastMile العامة تحت /api/public/v1.

المصادقة

  • مفتاح API وسرّه (X-API-Key وX-API-Secret) بثمانية نطاقات: shipments:read وshipments:write وmerchants:read وmerchants:write وgeography:read وpricing:read وbranches:read وwebhooks:manage.
  • تسجيل الدخول باسم المستخدم وكلمة المرور عبر POST /auth/login، ورموز تجديد تُستخدم مرة واحدة عبر POST /auth/refresh، وحسابات تجار ترى بياناتها فقط.
  • GET /auth/me لمعرفة الاعتماد الحالي.

الشحنات

  • الإنشاء (لتاجر أو لمرسل مخصص) والعرض والتتبع والتعديل والإلغاء وطباعة البوليصة، مع فهرس الحالات.
  • أنواع الخدمة: التوصيل والاستبدال والإرجاع؛ ودرجات standard وexpress وsameDay.
  • Idempotency-Key اختياري في عمليات الإنشاء، مع إعادة الرد الأول لمدة 24 ساعة.

الأماكن

  • الدول والمدن والأحياء بالمعرّف أو الرمز أو الاسم العربي أو الإنجليزي، بمطابقة متسامحة ومقترحات «هل تقصد».
  • GET /geography/resolve للتحقق من العنوان، ونقاط التغطية للمدن التي تخدمها الشركة.

التجار والتسعير والفروع والـ Webhooks

  • التجار وعناوين الاستلام المحفوظة لهم، مع كشف التكرار.
  • POST /pricing/quote مع إشارة deliverable وتفصيل السعر.
  • الفروع (قراءة فقط).
  • اشتراكات Webhooks لكل تاجر، موقّعة بـ HMAC-SHA256، مع إرسال اختباري وتدوير السر وإعادة محاولة تلقائية.

المنصة

  • جسم خطأ واحد لكل رد غير 2xx، ورموز أخطاء ثابتة، ووثيقة OpenAPI 3 مولَّدة تُقدَّم على /api/public/v1/openapi.json.
  • تحديد معدل على مرحلتين: لكل عنوان IP قبل المصادقة (600 طلب في الدقيقة افتراضياً، وIPv6 حسب /64) ولكل مستدعٍ موثَّق بعدها (120 في الدقيقة افتراضياً).
  • الطلب الذي يرسل رمز Bearer ومفتاح API معاً يُرفض بـ 400 ambiguous_credentials.
  • حالة الشركة الموقوفة أو المنتهية (tenant_blocked) تُفرض مع كل طلب.
  • صلاحيات لوحة تحكم محددة بالضبط للدخول بكلمة المرور عند كتابة الشحنات (orders:create وorders:update وorders:cancel)؛ ولا يُنشأ مفتاح API بنطاقات تتجاوز صلاحيات منشئه.
  • حدود عليا للوزن والأبعاد والقطع والقيمة المصرّح بها ومبلغ التحصيل.
  • الأماكن تقبل معرّفاً أو رمزاً أو اسماً في كل مكان، ويمكن أن يغيّر تعديل الشحنة الحي وحده.