كيف أوجّه عميل ShipsGo v2 نحو Dockflow دون إعادة كتابته؟

الأسئلة والأجوبة حول كيفية التنفيذ
1

لدي عميل مبني على واجهة ShipsGo v2 لبيانات المحيطات. هل يمكنه العمل على Dockflow بنفس المسارات ونصوص الطلبات؟

نعم. غيّر قيمتين:

  1. اضبط عنوان URL الأساسي على https://api.dockflow.com/compat/shipsgo/v2
  2. ضع مفتاح API الخاص بـ Dockflow في X-Shipsgo-User-Token. أنشئ المفتاح في وحدة تحكم API بنطاق Downstream.

إليك حالة تطبيقية بمفتاح وهمي. أنشئ شحنة:

POST /compat/shipsgo/v2/ocean/shipments
X-Shipsgo-User-Token: prod_acme_FAKE-TOKEN

{"reference":"PO-5521","booking_number":"BK-7741"}

تحتوي الاستجابة على معرّف الشحنة. اقرأها مرة أخرى باستخدام ذلك المعرّف. هذه الاستجابة مختصرة:

GET /compat/shipsgo/v2/ocean/shipments/74123

{"message":"SUCCESS","shipment":{"id":74123,
 "reference":"PO-5521","booking_number":"BK-7741",
 "status":"BOOKED"}}

هناك ثلاثة اختلافات. تُرفض عوامل تصفية القائمة بخلاف المعرّف ورقم الحاوية، وتبقى المتابعون والوسوم فارغة، ولا تُغطّى المسارات الجوية. تُرتَّب القائمة حسب آخر تغيير، من الأقدم إلى الأحدث، ويُرفض كل order_by. وإلى أن يتم تشغيل الاستيراد، لا يُظهر أي قراءة سوى الرقم الذي أرسلته. يضيف دعم Dockflow وجهات Webhook، وتحمل كل عملية تسليم ترويسة X-Shipsgo-Webhook-Signature.

خريطة الحقول الكاملة والتحقق من التوقيع: