وقت القراءة: 5 دقائق
منصة الأسطول
تطبيق الموبايل

إنشاء عمليات تكامل مخصصة
باستخدام واجهة برمجة تطبيقات Zeo

قم بتوصيل أنظمتك بـ Zeo باستخدام واجهة برمجة التطبيقات RESTful الخاصة بنا. أنشئ مسارات،
تتبع التقدم في الوقت الفعلي، وقم بأتمتة سير العمل باستخدام روابط الويب.

واجهة برمجة تطبيقات Zeo وخطافات الويب، مخطط مسار Zeo
  • 99.9%

    اتفاقية مستوى الخدمة لوقت تشغيل واجهة برمجة التطبيقات

  • 100ms

    متوسط ​​وقت الاستجابة

  • أكثر من 20

    نقاط النهاية API

  • 10K

    عدد الطلبات/الحد الأقصى للدقيقة

منصة المطور شرح المميزات:

كل ما تحتاجه لدمج تخطيط المسار في تطبيقاتك

  • واجهة برمجة تطبيقات Zeo وخطافات الويب، مخطط مسار Zeo

    REST API

    واجهة برمجة تطبيقات RESTful كاملة الميزات لإدارة المسارات والمحطات والسائقين وغير ذلك. تنسيق طلب/استجابة JSON مع توثيق شامل.

    • إنشاء المسارات وتحسينها برمجيًا
    • إدارة نقاط التوقف والسائقين والمركبات
    • استرجاع بيانات التتبع في الوقت الفعلي
    • الوصول إلى التحليلات والتقارير
    • دعم العمليات بالجملة
  • واجهة برمجة تطبيقات Zeo وخطافات الويب، مخطط مسار Zeo

    أحداث الويب هوك

    إشعارات الأحداث في الوقت الفعلي تُرسل إلى نقاط النهاية الخاصة بك. تفاعل فوراً مع تغييرات المسار، وإتمام عمليات الإيقاف، وتحديثات السائق.

    • أحداث بدء/انتهاء المسار
    • إيقاف إشعارات تغيير الحالة
    • تحديثات موقع السائق
    • تنبيهات تغيير وقت الوصول المتوقع
  • واجهة برمجة تطبيقات Zeo وخطافات الويب، مخطط مسار Zeo

    التحقّق من المُستخدم

    تأمين الوصول إلى واجهة برمجة التطبيقات (API) باستخدام مصادقة متوافقة مع معايير الصناعة. أنواع متعددة من المفاتيح لمستويات وصول وحالات استخدام مختلفة.

    • مصادقة رمز حامل
    • لوحة تحكم إدارة مفاتيح واجهة برمجة التطبيقات
    • نطاق الأذونات لكل مفتاح
    • دعم تدوير المفاتيح
    • تحديد معدل الاستخدام لكل مفتاح
  • واجهة برمجة تطبيقات Zeo وخطافات الويب، مخطط مسار Zeo

    استيراد من طرف ثالث

    استورد الطلبات والوظائف بسلاسة من الأنظمة الخارجية. التحقق التلقائي من صحة العناوين وتحديد الموقع الجغرافي عند الاستيراد.

    • نقطة نهاية الاستيراد لإيقاف الاستيراد بالجملة
    • التحقق من صحة العنوان والترميز الجغرافي
    • تعيين الحقل المخصص
    • كشف مكرر
    • تتبع حالة الاستيراد

webhook الفعاليات

اشترك في الأحداث في الوقت الفعلي وتفاعل فورًا مع تغييرات المسار

  • الإطار 1707478314 20 1، مخطط مسار زيو

    تم بدء المسار

    يتم تشغيلها عندما يبدأ السائق في تحديد مسار الرحلة. تتضمن معرف المسار ومعلومات السائق والوقت المقدر لإنجاز الرحلة.

  • الإطار 1707478314 19، مخطط الطريق زيو

    تم إيقاف العملية.

    يتم تشغيلها عند وضع علامة "مكتمل" على المحطة. تحتوي على بيانات إثبات الخدمة والطوابع الزمنية والملاحظات.

  • الإطار 1707478314 17، مخطط الطريق زيو

    فشل التوقف

    يتم إرسالها عندما يتعذر إكمال عملية التوقف. تتضمن سبب الفشل وأي صور/ملاحظات تم التقاطها.

  • المجموعة 11880، مخطط الطريق زيو

    تحديث موقع السائق

    تحديثات دورية لموقع السائقين النشطين. تردد قابل للضبط من 30 ثانية إلى 5 دقائق.

  • مجموعة 11880 1، مخطط الطريق زيو

    تم تغيير تاريخ انتهاء الصلاحية

    يتم فصل الموظف عندما تتغير أوقات الوصول المقدرة بشكل كبير بسبب حركة المرور أو التأخيرات.

  • مجموعة 11880 2، مخطط الطريق زيو

    تم إكمال المسار

    يتم تشغيلها عند الانتهاء من جميع المحطات. تتضمن الإحصائيات النهائية والمدة ومقاييس الأداء.

  • // مثال على حمولة Webhook
    {
      "حدث": "توقف. اكتمل",
      "الطابع الزمني": "2024-01-15T14:32:00Z",
      "البيانات": {
        "route_id": "route_abc123",
        "stop_id": "stop_xyz789",
        "سائق": {
          "بطاقة تعريف": "drv_456",
          "الاسم": "جون سميث"
        },
        "completed_at": "2024-01-15T14:31:45Z",
        "دليل": {
          "إمضاء": "https://...",
          "صور": ["https://..."],
          "ملحوظات": "يُترك عند الباب"
        } } }

    نقاط نهاية API نظرة عامة

    نقاط النهاية الأساسية لتخطيط المسارات وإدارة الأسطول

    سأعين
    /v1/routes

    أنشئ مسارًا جديدًا مع نقاط توقف وإعدادات تحسين

    للحصول على
    /v1/routes/{id}

    استرجاع تفاصيل المسار بما في ذلك التسلسل الأمثل

    سأعين
    /v1/routes/{id}/optimize

    إعادة تحسين مسار موجود باستخدام معلمات محدثة

    للحصول على
    /v1/routes/{id}/tracking

    احصل على بيانات تتبع في الوقت الفعلي للمسار النشط

    سأعين
    /v1/stops/import

    توقف الاستيراد المجمع من الأنظمة الخارجية

    ضع
    /v1/stops/{id}/status

    تحديث حالة الإيقاف (مكتمل، فاشل، متجاوز)

    للحصول على
    /v1/drivers

    اعرض جميع السائقين مع حالة توافرهم

    للحصول على
    /v1/drivers/{id}/location

    احصل على الموقع الحالي وتقدم المسار

    سأعين
    /v1/webhooks

    قم بتسجيل نقطة نهاية webhook لتلقي إشعارات الأحداث

    رمز أمثلة

    ابدأ بسرعة مع أمثلة بلغتك المفضلة



    أنشئ مسارًا وحسّنه مع محطات متعددة
    حليقة -X مشاركة "https://api.zeoroute.com/v1/routes" -H "التفويض: حامل $ZEO_API_KEY" -H "Content-Type: application/json"'{ "name": "توصيلات الصباح", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 شارع المستودع، المدينة" }, "stops": [ { "address": "456 شارع العميل", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "789 شارع الأعمال", "priority": "high", "service_time": 30 } ] }'
    
    احصل على تفاصيل المسار
    curl -X GET "https://api.zeoroute.com/v1/routes/route_abc123" -H "التفويض: حامل $ZEO_API_KEY"
    
    تحديث حالة الإيقاف
    حليقة -X PUT "https://api.zeoroute.com/v1/stops/stop_xyz789/status" -H "التفويض: حامل $ZEO_API_KEY" -H "Content-Type: application/json"'{"status": "completed", "notes": "Left at door"}'

    الاندماج استخدم حالات

    تُعدّ التحديثات التلقائية مفيدة لأي قطاع صناعي يتضمن زيارات مجدولة.

    التسليم

    تكامل إدارة الطلبات

    تقوم منصة التجارة الإلكترونية باستيراد الطلبات الجديدة تلقائيًا عبر واجهة برمجة التطبيقات (API) كل ساعة. تُصنّف الطلبات حسب المنطقة، وتُحسّن مسارات التوصيل، ثم تُرسل إلى السائقين. تُحدّث إشعارات الويب هوك حالة الطلب في الوقت الفعلي عند اكتمال عمليات التسليم.

    الخدمة الميدانية

    جدولة الخدمات المدفوعة بنظام إدارة علاقات العملاء

    تقوم شركة خدمات ميدانية بمزامنة أوامر العمل من نظام إدارة علاقات العملاء (CRM) الخاص بها عبر واجهة برمجة التطبيقات (API). تُنشئ المهام الجديدة تلقائيًا نقاط توقف تتضمن تفاصيل العميل ومتطلبات الخدمة والنطاقات الزمنية. تُحدّث روابط الويب الخاصة بإتمام العمل نظام إدارة علاقات العملاء (CRM) وتُفعّل عملية إصدار الفواتير.

    المجموعة 1707478361، مخطط الطريق زيو

    جاهز للبناء اندماجك؟

    احصل على مفتاح API الخاص بك وابدأ في البناء في دقائق مع وثائقنا الشاملة

    المجموعة 1707478363، مخطط الطريق زيو

    استبيان زيو



    الأسئلة المتكررة

    المزيد

    واجهة برمجة تطبيقات Zeo وخطافات الويب

    ما هي حدود معدل استخدام واجهة برمجة التطبيقات (API)؟

    تتيح مفاتيح واجهة برمجة التطبيقات القياسية 1,000 طلب في الدقيقة. أما خطط المؤسسات فتتيح طلب حدود أعلى تصل إلى 10,000 طلب في الدقيقة. يتم تضمين رؤوس تحديد معدل الطلبات في كل استجابة لتتمكن من تتبع استخدامك.

    كيف يمكنني التحقق من صحة طلبات واجهة برمجة التطبيقات (API)؟

    تتطلب جميع طلبات واجهة برمجة التطبيقات (API) رمزًا مميزًا (Bearer token) في ترويسة المصادقة (Authorization). يمكنك إنشاء مفاتيح واجهة برمجة التطبيقات من إعدادات حسابك. يمكن تحديد نطاق المفاتيح وفقًا لأذونات معينة (للقراءة فقط، أو الكتابة، أو صلاحيات المسؤول) وعناوين IP.

    هل لديكم حزم تطوير برمجية (SDKs) للغات مختلفة؟

    نُقدّم حزم تطوير برمجية رسمية للغات JavaScript/Node.js وPython. كما تتوفر حزم تطوير برمجية أخرى تُدار من قِبل المجتمع للغات Ruby وPHP وGo. جميع حزم التطوير البرمجية مفتوحة المصدر ومتاحة على GitHub.

    كيف تعمل عمليات إعادة المحاولة الخاصة بخطاف الويب؟

    إذا أعاد خادمك استجابةً غير 2xx، فسنعيد المحاولة مع تأخير زمني متزايد: دقيقة واحدة، 5 دقائق، 30 دقيقة، ساعتان، و24 ساعة. بعد 5 محاولات فاشلة، سيتم وضع علامة "فشل" على رابط الويب وسيتم إخطارك عبر البريد الإلكتروني.

    هل توجد بيئة اختبار تجريبية (Sandbox)؟

    نعم، نوفر بيئة اختبار كاملة على api-sandbox.zeoroute.com. تحتوي بيئة الاختبار على نفس واجهة برمجة التطبيقات (API) ولكن مع بيانات اختبارية وبدون أي رسوم. مثالية للتطوير واختبار التكامل.

    هل واجهة برمجة التطبيقات (API) متاحة في جميع الباقات؟

    تتوفر واجهة برمجة تطبيقات Zeo REST في باقات إدارة الأساطيل وباقات المؤسسات. وهي تشمل إدارة كاملة للمسارات، وعمليات التوقف، وإدارة السائقين، ودعم Webhook لإشعارات الأحداث في الوقت الفعلي.

    لماذا أستخدم واجهة برمجة تطبيقات Zeo بدلاً من إدخال البيانات يدويًا؟

    تتيح لك واجهة برمجة التطبيقات (API) الخاصة بـ Zeo إنشاء المسارات برمجيًا، وإدارة نقاط التوقف، ومزامنة التتبع في الوقت الفعلي مع أنظمتك الخاصة، مما يلغي العمل اليدوي المتكرر.

    ما المشاكل التي تحلها روابط الويب في سير العمل الآلي؟

    تقوم Webhooks بإرسال إشعارات الأحداث في الوقت الفعلي مثل اكتمال الإيقاف أو بدء المسار إلى نقطة النهاية الخاصة بك حتى تتمكن الأنظمة من التفاعل على الفور دون الحاجة إلى التحقق من التحديثات.

    هل يمكنني إنشاء عمليات أتمتة مخصصة باستخدام واجهة برمجة التطبيقات (API)؟

    نعم. يمكنك دمج Zeo مع الأدوات الداخلية أو أنظمة تخطيط موارد المؤسسات أو التطبيقات المخصصة باستخدام واجهة برمجة تطبيقات REST كاملة تدعم إنشاء الكيانات واسترداد التفاصيل.

    كيف تُحسّن البيانات الآنية عبر روابط الويب العمليات؟

    توفر روابط الويب تحديثات فورية حول تقدم المسار، وتغييرات وقت الوصول المتوقع، وموقع السائق، بحيث تبقى الأنظمة والفرق متزامنة دون الحاجة إلى تحديثات يدوية.

    ما هي أنواع الأحداث التي يمكن أن تُعلمني بها روابط الويب؟

    تُستخدم Webhooks لتشغيل أحداث مثل بدء المسار، وإكمال التوقف، وتحديثات برنامج التشغيل، وغيرها من عمليات تقدم المسار في أنظمتك.

    هل استخدام واجهة برمجة التطبيقات (API) وخطافات الويب مفيد لتوسيع نطاق العمليات؟

    بالتأكيد. فهي تسمح للمطورين بأتمتة كميات كبيرة من بيانات التوجيه ودمج Zeo بشكل عميق في سير العمل المؤسسي مع نمو الأعمال.

    زيو مدونات

    استكشف مدونتنا للحصول على مقالات مفيدة ونصائح الخبراء ومحتوى ملهم يبقيك على اطلاع.

    9 فبراير 2026: برنامج تحسين مسارات مُعدِّلي التأمين، برنامج Zeo Route Planner

    دليل برامج تحسين مسارات مُعدِّلي التأمين 2026

    وقت القراءة: 6 دقائق اكتشف كيف يمكن لبرامج تحسين مسارات مُعدِّلي التأمين أن تقلل وقت معالجة المطالبات بنسبة 45% وتخفض تكاليف السفر بنسبة 35% لمديري المطالبات.

    9 فبراير 2026 - بديل توكان المميز، مخطط مسار زيو

    أفضل بديل لـ Tookan لعام 2026: دليل الهجرة الكامل

    وقت القراءة: 7 دقائق هل تبحث عن بديل لـ Tookan؟ قارن بين أفضل منصات تحسين المسارات، واطلع على حاسبات عائد الاستثمار، واحصل على أدلة ترحيل خطوة بخطوة لعام 2026.

    9 فبراير 2026: بديل مميز لبرنامج Routeware، برنامج Zeo لتخطيط المسارات

    أفضل بديل لبرنامج RouteWare لشركات إدارة النفايات

    وقت القراءة: 6 دقائق اكتشف بدائل RouteWare بأسعار معقولة تُسهّل عملية تحديد مسارات جمع النفايات. قارن بين التكاليف والميزات وسهولة الاستخدام لعمليات جمع النفايات التي تتراوح بين 5 و50 شاحنة.