وثائق تكامل REST API الشريك للشوفير وwebhook

منصة المطوّر

تكامل API

تتيح REST وwebhooks للشركاء توزيع عرض وطلب الشوفير برمجياً.

وثائق تكامل REST API الشريك للشوفير وwebhook
نظرة عامة

التوزيع البرمجي

يستقبل الشركاء عروض رحلات مدفوعة أو واردة مع فئة المركبة والتسعير وبيانات SLA.

تقبل نقاط نهاية إنشاء الحجز مسارات منظّمة مع معرّفات أماكن مبنى المطار.

تبثّ webhooks انتقالات الحالة — مُعيَّن وفي الطريق ومكتمل — إلى نقاط نهاية الشريك.

  • بيانات اعتماد عميل OAuth
  • نقاط نهاية عروض الرحلات
  • webhooks الحالة
  • مواصفة OpenAPI
كيف يعمل

من مفتاح صندوق الحماية إلى حركة مرور الإنتاج

  • الخطوة 1

    الإعداد

    يتلقى الشركاء بيانات اعتماد صندوق الحماية وحمولات نموذجية في البوابة.

  • الخطوة 2

    الاعتماد

    تتحقق نصوص الاختبار المشتركة من تدفقات القبول والإلغاء وتوقيع webhook.

  • الخطوة 3

    التوسع

    تُفعَّل مفاتيح الإنتاج مع حدود معدل لكل مستأجر ولوحات مراقبة.

وثائق تكامل REST API الشريك للشوفير وwebhook
الفوائد

نتائج المطوّر

  • طرح سريع في السوق

    تتكامل وكالات السياحة الإلكترونية دون هندسة مخصصة من فريق Red Carpet.

  • عمليات مدفوعة بالأحداث

    تُزيل webhooks حمل الاستطلاع وتُقلّص زمن تأخير الحالة.

  • استقرار الإصدار

    يحمي الإصدار الدلالي التكاملات الحالية عند توسّع الحقول.

الأمان — تكامل API
الأمان

أمان API

تتجدد بيانات اعتماد عميل OAuth من بوابة الشريك مع إبطال فوري.

تستخدم توقيعات webhook HMAC-SHA256 مع تحمّل الطابع الزمني لحجب إعادة التشغيل.

  • تدوير بيانات اعتماد العميل
  • HMAC لـ webhook
  • حدود معدل لكل مستأجر
  • قوائم سماح IP اختيارية
التكامل — تكامل API
التكامل

مساحة السطح

يوثّق OpenAPI عروض الرحلات والحجوزات والإلغاءات وردود استدعاء حالة السائق.

تُشحن مجموعات Postman ومستهلكو NestJS النموذجيون مع حزم الاعتماد.

  • مواصفة OpenAPI 3.1
  • مجموعة Postman
  • webhooks صندوق الحماية
  • لوحة مقاييس الاستخدام
حالات الاستخدام — تكامل API
حالات الاستخدام

أنماط التكامل

  • طلب وكالات السياحة الإلكترونية

    تدفع الأسواق عروضاً إلى شركاء العرض الإقليميين للقبول.

  • ERP المؤسسي

    تُنشئ الشركات مسارات معتمدة من أدوات السفر الداخلية.

  • PMS الفندق

    تربط العقارات النقل البري بحجوزات الغرف تلقائياً.

الدعم

أسئلة شائعة حول API