البدء السريع

1. احصل على بيانات اعتماد البيئة التجريبية

سجّل في صفحة واجهات السفر البرمجية. بمجرد التحقق من بريدك الإلكتروني، يصبح حساب الشريك الخاص بك موجودًا ويظهر معرّف مفتاح البيئة التجريبية على الشاشة؛ أما المفتاح السري فيُسلَّم عبر رابط كشف يُستخدم مرة واحدة ويُرسل إلى العنوان نفسه. احفظه في مدير الأسرار لديك — فهو يُعرض مرة واحدة فقط.

ستتلقى أيضًا كلمة مرور مؤقتة لبوابة المطوّرين، حيث يمكنك إنشاء المفاتيح وتدويرها، وضبط قائمة السماح لعناوين IP، ومتابعة الاستخدام، وطلب الإنتاج.

2. وقّع كل طلب

يحمل كل استدعاء أربع ترويسات: X-API-Key (معرّف مفتاحك)، و X-Timestamp (ثوانٍ بتوقيت يونكس)، و X-Nonce (من 16 إلى 128 حرفًا عشوائيًا)، و X-Signature — وهو HMAC-SHA256 لسلسلة قانونية بصيغة hex بأحرف صغيرة، مع استخدام مفتاحك السري كمفتاح.

السلسلة القانونية خمسة أسطر يفصل بينها محرف سطر جديد: أسلوب HTTP بأحرف كبيرة، والمسار مع سلسلة الاستعلام تمامًا كما أُرسلت، والطابع الزمني، والـ nonce، وقيمة SHA-256 للنص الخام بصيغة hex بأحرف صغيرة (النص الفارغ يُحسب له SHA-256 لصفر بايت). يجب أن تكون الطوابع الزمنية ضمن 300 ثانية من ساعتنا؛ ولا يمكن استخدام الـ nonce إلا مرة واحدة خلال 10 دقائق.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. نفّذ أول استدعاء

ابحث عن رحلة طيران في البيئة التجريبية. البيئة التجريبية موصولة ببيئات الاختبار لدى مورّدينا، لذا تُعيد عمليات البحث مخزونًا وأسعارًا تجريبية، وأي حجز يُنشأ فيها هو حجز تجريبي — لا تذكرة حقيقية ولا أي رسوم. تتضمن كل صفحة مرجعية مثالًا كاملًا بلغات cURL و Node.js و Python و PHP — انسخه، وأدخل معرّف مفتاحك والمفتاح السري، ثم شغّله.

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. أكمل مسار حجز

الطيران: البحث ← تسعير العرض المختار ← إنشاء الطلب مع المسافرين وجهة الاتصال ← إصدار التذكرة ← (اختياريًا) طلب عرض استرجاع ثم تقديم طلب الاسترجاع. الفنادق: البحث ← قراءة غرف المنشأة ← التحقق من السعر ← إنشاء الحجز ← (اختياريًا) طلب عرض الإلغاء ثم الإلغاء.

معرّفات العروض ومفاتيح الأسعار معتمة وقصيرة العمر. سعّر أو تحقق دائمًا قبل الالتزام مباشرة: إذا تغيّر السعر فستتلقى 409 price_changed مع المبلغ الجديد، والقرار لك.

5. اطلب الإنتاج

عندما يُكمل تكاملك المسار من البداية إلى النهاية في البيئة التجريبية، افتح بوابة المطوّرين واطلب الإنتاج. نراجع نشاط البيئة التجريبية (عمليات بحث، وطلبًا، وحجزًا، وإلغاءً) وتفاصيل تكاملك، ثم ننقل حسابك: يُرسل زوج مفاتيح الإنتاج بالبريد الإلكتروني عبر رابط الكشف نفسه الذي يُستخدم مرة واحدة. عنوان URL الأساسي نفسه — الطلبات الموقّعة بمفتاح dt_live_ تصل إلى المورّدين الحيّين وتُسوّى من وديعتك؛ ويظل مفتاح البيئة التجريبية يعمل للاختبار.