المنصة
TravelDistro: واجهة API واحدة لسفر الوكالات
مفتاح واحد ورصيد مدفوع مسبقًا واحد للنقل والجولات والتذاكر وeSIM والطيران والسيارات والقاعات والأدلة الصوتية.
لمحة سريعة
- الوصول
- للوكالات المرخّصة فقط
- طرف التعاقد
- Rate Extra Tourism L.L.C
- عملات التسوية
- AED, USD, EUR, GBP, TRY
- التوثيق
- api.traveldistro.com/docs
لمن هذا المنتج
- واجهات API للوكالات الإلكترونية: تأشيرات وeSIMوكالات إلكترونية تدمج عدة قطاعات في صفحة دفع واحدة.
- تأشيرات وخدمات أرضية لمنظمي الرحلات وDMCمنظمو رحلات وشركات إدارة وجهات يجمّعون الخدمات الأرضية.
- تأشيرات الإمارات وواجهات API لوكالات السفروكالات تجزئة تريد عقد مورّد واحد.
- API تأشيرات الإمارات والنقل لوكالات سفر الشركاتوكالات شركات تحتاج إلى فوترة موحّدة.
الإمكانات
- 01مفتاح API واحد ورصيد مدفوع مسبقًا واحد يغطيان كل قطاعات المنتجات في عقدك.
- 02المنتجات خارج عقدك تُرجع 403 MODULE_NOT_ENABLED؛ ويعرض GET /v1/account ما هو مفتوح.
- 03تُوقَّع الطلبات بـ TD-HMAC-SHA256: طابع زمني ضمن 300 ثانية وقيمة nonce لكل طلب. لا يُدعم Bearer token.
- 04حدود المعدل لكل وكالة، وتُحسب القراءة والكتابة بشكل منفصل في نافذة متحركة مدتها دقيقة، مع ترويسات X-RateLimit-*. الاستجابة 429 لا تحجز ولا تخصم شيئًا.
- 05يتطلب الحجز والإلغاء Idempotency-Key؛ ويعيد المفتاح والمحتوى نفسهما الاستجابة الأصلية.
- 06كل خطأ يستخدم غلافًا واحدًا برمز error.code ثابت.
- 07webhooks الصادرة موقّعة، ويُعاد إرسالها مرتين مع تراجع أُسّي، وقابلة لإزالة التكرار عبر X-TD-Webhook-Id.
- 08الحساب ورصيد المحفظة وكشف المحفظة وأسعار الصرف متاحة عبر API.
كيف يتم التكامل
قدّم الطلب، واجتز مراجعة الرخصة، ووقّع العقد واشحن المحفظة، واستلم معرّف المفتاح والسر، ثم أطلق. العنوان الأساسي: https://api.traveldistro.com/v1. الدعم التقني: api@traveldistro.com.
- 01
قدّم الطلب
- 02
المراجعة
- 03
العقد والمحفظة
- 04
المفاتيح
- 05
الإطلاق
الأسئلة الشائعة
هل أحتاج إلى عقد منفصل لكل منتج؟
لا. عقد واحد مع Rate Extra يحدد القطاعات التي يمكنك استدعاؤها؛ والمفتاح والرصيد نفسهما يخدمانها جميعًا.
هل يمكنني استخدام Bearer token؟
لا. كل طلب يُوقَّع بـ TD-HMAC-SHA256. راجع صفحة المصادقة لمثال عملي.
ماذا يحدث عند استدعاء منتج خارج عقدي؟
تُرجع API الاستجابة 403 MODULE_NOT_ENABLED على كل نقطة نهاية تخص ذلك المنتج. لا يُحجز ولا يُخصم شيء.
هل توجد بيئة اختبار (sandbox)؟
لا تعرض TravelDistro مضيف sandbox منفصلًا في المرجع العام. تملك Hotel API من Safaryar Holidays علامة sandbox؛ أما المنتجات الأخرى فتُختبر بمفتاحك الحي عبر حجوزات صغيرة قابلة للإلغاء يُتفق عليها مع فريق التسجيل.
أين مرجع API؟
متاح للعموم على api.traveldistro.com/docs، مع ملف OpenAPI على /docs/openapi.yaml.
وكالة سفر مرخّصة؟ قدّم طلب الوصول إلى API.
احصل على وصول API