وقت القراءة: 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 لإشعارات الأحداث في الوقت الفعلي.

    زيو مدونات

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

    23 يناير 2026: ميزة تحسين مسار خدمة أجهزة الصراف الآلي، مخطط مسار زيو

    تحسين مسارات خدمة أجهزة الصراف الآلي: خفض التكاليف بنسبة 25% بحلول عام 2026

    وقت القراءة: 7 دقائق حسّن عمليات خدمة أجهزة الصراف الآلي من خلال تحسين المسارات الذكي. خفّض التكاليف بنسبة 25% مع تحسين الأمن ووقت التشغيل. حلول عملية للمديرين.

    23 يناير 2026: كيفية تقليل وقت السفر للتفتيش - مُميز، مُخطط مسار زيو

    كيفية تقليل وقت السفر للتفتيش لتحسين كفاءة الأسطول

    وقت القراءة: 7 دقائق تعرّف على استراتيجيات مجرّبة لتقليل وقت سفر عمليات التفتيش لأسطول مركباتك. حسّن جدولة الرحلات، والتنسيق عبر الأجهزة المحمولة، وتحديد المسارات لتقليل تكاليف التوقف عن العمل.

    23 يناير 2026: كيفية إدارة مسارات خدمة المسابح المتعددة (مُميزة، مُخطط مسارات زيو)

    كيفية إدارة مسارات خدمة المسابح المتعددة بكفاءة

    وقت القراءة: 8 دقائق تعلم استراتيجيات مثبتة لإدارة مسارات خدمة حمامات السباحة المتعددة، وتقليل وقت القيادة بنسبة 30٪، والقضاء على عمليات التنظيف الفائتة، والتوسع بشكل مربح إلى مناطق جديدة.