الواجهة البرمجية · v1
الطلبات تدخل والمسارات تخرج
ادفع المهام من النظام الذي تشغّله أصلًا واستقبل مسارًا مرتّبًا مع بقاء معرّفاتك كما هي. ثلاث نقاط نهاية ودون حاجة إلى حزمة تطوير.
العنوان الأساسي
api.routemate.app/v1
المصادقة
OAuth2 client_credentials
مدة صلاحية الرمز
3600 s
التوفر
خطة Team فما فوق
ثلاثة استدعاءات، وهذا كامل السطح
| الأسلوب | المسار | الغرض |
|---|---|---|
| POST | /v1/integration-token | مبادلة بيانات اعتماد العميل برمز حامل صالح لساعة واحدة |
| POST | /v1/integration-import | استيراد مهمة بمحطاتها، وترميز العناوين جغرافيًا، وتحسين المسار، وتخصيص السائق — في طلب واحد |
| GET | /v1/integration-jobs | حالة المهمة والمحطات: عدّادات التقدّم، وحالة كل محطة، والترتيب بعد التحسين |
استيراد وترميز وتحسين وتخصيص
الطلب
POST /v1/integration-import HTTP/1.1
Authorization: Bearer {token}
Content-Type: application/json
{
"external_job_id": "WMS-2026-07-30-A",
"driver_email": "driver@fleet.com.au",
"optimize": true,
"stops": [
{ "external_stop_id": "SO-88214",
"address": "3/216 Brunswick St, Fitzroy VIC 3065",
"parcel_count": 2,
"duration_minutes": 4 }
]
}الاستجابة · 200 OK
{
"job_id": "job_7Yq2c",
"external_job_id": "WMS-2026-07-30-A",
"assigned_to": "driver@fleet.com.au",
"optimized": true,
"stops_imported": 142,
"stops": [
{ "external_stop_id": "SO-88214",
"stop_id": "stp_9f2",
"sequence": 38,
"status": "pending" }
],
"warnings": []
}معرّفاتك تبقى كما هي
كل معرّف ترسله يعود إليك في المخرجات، على المهمة وعلى كل محطة. فلست مضطرًا أبدًا إلى الاحتفاظ بجدول مطابقة بين أرقام طلباتك وأرقامنا.
| external_job_id | مرجع الدفعة الخاص بك — يعود مع كل محطة، فلا تحتاج إلى جدول مطابقة |
| external_stop_id | رقم طلبك أو شحنتك، ويُنقل حتى الحالة والإنجاز |
| address | سطر عنوان واحد، يُرمَّز جغرافيًا عند الاستيراد وتعود الإخفاقات كتحذيرات |
| parcel_count | يُستخدم في افتراضات الحمولة والمناولة عند المحطة |
| duration_minutes | وقت الخدمة عند الباب — يُستهلك في النموذج ولا يُتجاهل |
| driver_email | يخصّص المسار المكتمل لسائق موجود أصلًا في الحساب |
ما يحدث عند حدوث خلل
كتابات مُتَماثِلة
إعادة استيراد المعرّف external_job_id نفسه تُحدّث المهمة بدل إنشاء ثانية. وإعادة المحاولة بعد انتهاء المهلة آمنة.
نجاح جزئي
المحطة التي يتعذّر ترميزها جغرافيًا تعود ضمن warnings[] بينما تُستورد بقية المهمة. ولا يفشل الطلب بأكمله لأن عنوانًا واحدًا خاطئ.
إصدار الواجهة
الإصدار مذكور في المسار. وتُضاف الحقول داخل الإصدار الواحد دون أن تُحذف أو يُعاد توظيفها، فيظل التكامل المكتوب اليوم يعمل.
مفاتيح البيئة التجريبية مجانية
طوّر على بيئة تجريبية قبل أن تلتزم بأي شيء. اطلب منا وسنرسل بيانات الاعتماد ومثالًا مشروحًا على بنية بياناتك أنت.