سجل التغييرات
الإصدار الأول من واجهة 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 بنطاقات تتجاوز صلاحيات منشئه. - حدود عليا للوزن والأبعاد والقطع والقيمة المصرّح بها ومبلغ التحصيل.
- الأماكن تقبل معرّفاً أو رمزاً أو اسماً في كل مكان، ويمكن أن يغيّر تعديل الشحنة الحي وحده.