API الشحن
توثيق endpoints الشحن والتوصيل مع OTO في منصة مُلكم
واجهة برمجة الشحن تتيح لك انشاء شحنات، حساب تكلفة التوصيل، وتتبع الطرود عبر OTO.
oto-create-shipment
انشاء شحنة جديدة.
Method: POST
URL: /functions/v1/oto-create-shipment
Body:
Response (200):
oto-get-delivery-fees
حساب تكلفة الشحن قبل انشاء الشحنة.
Method: POST
URL: /functions/v1/oto-get-delivery-fees
Body:
Response (200):
oto-track-shipment
تتبع حالة الشحنة.
Method: POST
URL: /functions/v1/oto-track-shipment
Body:
Response (200):
حالات الشحنة:
| الحالة | الوصف |
|---|---|
CREATED | تم انشاء الشحنة |
PICKED_UP | تم الاستلام من التاجر |
IN_TRANSIT | في الطريق |
OUT_FOR_DELIVERY | خارج للتوصيل |
DELIVERED | تم التوصيل |
RETURNED | تم الارجاع |
oto-webhook
يستقبل تحديثات حالة الشحن من OTO تلقائيًا.
Method: POST
URL: /functions/v1/oto-webhook
يتم تحديث حالة الطلب في قاعدة البيانات وارسال اشعار للعميل تلقائيًا.
test-oto-connection
اختبار صحة اتصال OTO.
Method: POST
URL: /functions/v1/test-oto-connection
Response (200):