يوفر API الخاص بنا نقطة نهاية trackShipment التي تتيح لك تتبع شحنة باستخدام رقم التتبع واسم شركة التوصيل. يشرح هذا الدليل كيفية استرجاع تفاصيل تتبع الشحنة، بما في ذلك تحديثات الحالة وسجل التتبع.
التعليمات
الخطوة 1: نقطة نهاية API
- لتتبع شحنة، استخدم نقطة النهاية POST التالية:
https://api.tryoto.com/rest/v2/trackShipment
الخطوة 2: التفويض
- يجب تضمين رمز Bearer صالح في رؤوس الطلب للمصادقة
الخطوة 3: معلمات جسم الطلب
- يجب أن يكون جسم الطلب بتنسيق JSON ويشمل الحقول التالية:
| اسم الحقل | مطلوب | النوع | الوصف |
|---|---|---|---|
trackingNumber | نعم | String | رقم تتبع الشحنة. |
deliveryCompanyName | نعم | String | اسم شركة التوصيل التي تتولى الشحنة. |
statusHistory | لا | Boolean | اضبط على true لاسترجاع سجل حالة الشحنة. |
brandName | لا | String | اسم العلامة التجارية المرتبطة بالشحنة. |
الخطوة 4: مثال على الطلب
باستخدام cURL:
curl --location 'https://api.tryoto.com/rest/v2/trackShipment' \ --header 'Authorization: Bearer {{token}}' \ --data '{ "trackingNumber": "290692134777", "deliveryCompanyName":"smsaecom", "statusHistory":false }'
الخطوة 5: مثال على الاستجابة
- ستتضمن استجابة ناجحة تفاصيل التتبع وتاريخ الشحنة (إذا طُلب):
{ "trackingUrl": "https://www.smsaexpress.com/trackingdetails?tracknumbers%5B0%5D=290692134777", "success": true, "items": [ { "dcStatus": "DATA RECEIVED", "updateStatusDate": true, "shipmentId": "290692134777", "otoStatus": "shipmentCreated", "success": true, "dcUpdateDate": "2024-05-08T11:39:00", "dcDescription": "DATA RECEIVED - Online Data Submitted" } ] }
