نظرة عامة للمطورين
واجهتا API وعقد واحد. TravelDistro هي واجهة API للسفر بين الشركات من Rate Extra؛ أما Hotel API فتوفّرها Safaryar Holidays. هذه الصفحة خريطة مفاهيمية بروابط مباشرة إلى المراجع العامة، ولا تكررها.
TravelDistro API
- Auth
- TD-HMAC-SHA256 (Authorization وX-TD-Timestamp وX-TD-Nonce)
- Base URL
- https://api.traveldistro.com/v1
- Support
- api@traveldistro.com
Hotel API من Safaryar Holidays
يُتعاقد عليها بشكل منفصل مع Safaryar Holidays (Sindibad Turizm Ticaret A.Ş.)، إسطنبول.
- Auth
- ترويسة X-API-Key
- Base URL
- https://api.safaryarholidays.com
- Support
- support@safaryarholidays.com
مفتاح API ونطاق العقد
مفتاح واحد يغطي كل قطاع في عقدك. المنتج خارج العقد يُرجع 403 MODULE_NOT_ENABLED على كل نقاط نهايته؛ ويعرض GET /v1/account ما هو مفتوح.
المحفظة المدفوعة مسبقًا
تخصم الحجوزات من رصيد مدفوع مسبقًا بعملة متعاقد عليها. الرصيد والكشف وأسعار الصرف قابلة للقراءة عبر API. الاستجابة 429 أو الحجز الفاشل لا يخصمان شيئًا.
تدفق quote_token
كل بحث يُرجع نتائج مسعّرة مع quote_token يثبّت السعر حتى quote_expires_at. يستخدم الحجز الرمز؛ ولا تُخزَّن الأسعار مؤقتًا من جهتك أبدًا.
التكرار الآمن (Idempotency)
يتطلب الحجز والإلغاء Idempotency-Key. يعيد المفتاح والمحتوى نفسهما الاستجابة الأصلية، فلا يمكن لطلب معاد أن يحجز مرتين.
حدود المعدل
لكل وكالة؛ تُحسب القراءة والكتابة بشكل منفصل في نافذة متحركة مدتها دقيقة، وتُبلَّغ في ترويسات X-RateLimit-* مع Retry-After عند 429.
غلاف الخطأ
كل خطأ يستخدم غلافًا واحدًا برمز error.code ثابت وكائن details، فتتفرع العملاء بحسب الرموز لا الرسائل.
Webhooks
الأحداث الصادرة موقّعة، ويُعاد إرسالها مرتين مع تراجع أُسّي، وقابلة لإزالة التكرار عبر X-TD-Webhook-Id. توقّع Hotel API بـ X-Webhook-Signature ولا تعيد المحاولة.
وكالة سفر مرخّصة؟ قدّم طلب الوصول إلى API.
احصل على وصول API