فوری آغاز

1. سینڈ باکس اسناد حاصل کریں

سفری API صفحے پر رجسٹر کریں۔ ای میل کی تصدیق ہوتے ہی آپ کا پارٹنر اکاؤنٹ بن جاتا ہے اور اسکرین پر سینڈ باکس کلید ID دکھائی جاتی ہے؛ خفیہ کلید اسی پتے پر بھیجے گئے ایک بار استعمال ہونے والے لنک کے ذریعے ملتی ہے۔ اسے اپنے سیکرٹس مینیجر میں محفوظ کریں — یہ صرف ایک بار دکھائی جاتی ہے۔

آپ کو ڈویلپر پورٹل کے لیے ایک عارضی پاس ورڈ بھی ملتا ہے، جہاں آپ کلیدیں بنا اور تبدیل کر سکتے ہیں، IP اجازت فہرست مقرر کر سکتے ہیں، استعمال دیکھ سکتے ہیں اور پروڈکشن کی درخواست کر سکتے ہیں۔

2. ہر درخواست پر دستخط کریں

ہر کال میں چار ہیڈرز ہوتے ہیں: X-API-Key (آپ کی کلید ID)، X-Timestamp (unix سیکنڈز)، X-Nonce (16–128 بے ترتیب حروف) اور X-Signature — ایک کینونیکل اسٹرنگ کا چھوٹے حروف والا hex HMAC-SHA256، جس کی کلید آپ کی خفیہ کلید ہو۔

کینونیکل اسٹرنگ پانچ سطروں پر مشتمل ہے جو نئی سطر کے نشان سے جڑی ہوں: بڑے حروف میں HTTP طریقہ، پاتھ اور کوئری اسٹرنگ بالکل ویسے جیسے بھیجے گئے، ٹائم اسٹیمپ، nonce، اور خام باڈی کا چھوٹے حروف والا hex SHA-256 (خالی باڈی کا ہیش صفر بائٹس کا SHA-256 ہوتا ہے)۔ ٹائم اسٹیمپ ہماری گھڑی سے 300 سیکنڈ کے اندر ہونا چاہیے؛ ایک nonce کو 10 منٹ کے اندر صرف ایک بار استعمال کیا جا سکتا ہے۔

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. اپنی پہلی کال کریں

سینڈ باکس میں پرواز تلاش کریں۔ سینڈ باکس ہمارے فراہم کنندگان کے ٹیسٹ ماحول سے جڑا ہے، اس لیے تلاش میں ٹیسٹ انوینٹری اور قیمتیں آتی ہیں، اور وہاں کی گئی بکنگ ٹیسٹ بکنگ ہوتی ہے — نہ کوئی اصلی ٹکٹ، نہ کوئی چارج۔ ہر حوالہ صفحے پر cURL، Node.js، Python اور PHP میں مکمل نمونہ موجود ہے — اسے کاپی کریں، اپنی کلید ID اور خفیہ کلید درج کریں، اور چلائیں۔

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. بکنگ کا فلو مکمل کریں

پروازیں: تلاش → منتخب پیشکش کی قیمت → مسافروں اور رابطے کے ساتھ آرڈر بنانا → ٹکٹ جاری کرنا → (اختیاری) رقم واپسی کا تخمینہ اور درخواست۔ ہوٹل: تلاش → پراپرٹی کے کمرے دیکھنا → نرخ کی جانچ → بکنگ بنانا → (اختیاری) تخمینہ اور منسوخی۔

پیشکش IDs اور نرخ کلیدیں مبہم اور مختصر مدت کی ہوتی ہیں۔ حتمی کرنے سے عین پہلے ہمیشہ قیمت یا جانچ کریں: اگر قیمت بدل گئی ہو تو آپ کو نئی رقم کے ساتھ 409 price_changed ملتا ہے، اور فیصلہ آپ کا ہوتا ہے۔

5. پروڈکشن کی درخواست کریں

جب آپ کا انضمام سینڈ باکس میں فلو شروع سے آخر تک مکمل کر لے تو ڈویلپر پورٹل کھولیں اور پروڈکشن کی درخواست کریں۔ ہم سینڈ باکس سرگرمی (تلاشیں، ایک آرڈر، ایک بکنگ، ایک منسوخی) اور آپ کے انضمام کی تفصیلات کا جائزہ لیتے ہیں، پھر آپ کا اکاؤنٹ منتقل کرتے ہیں: پروڈکشن کلیدوں کا جوڑا اسی ایک بار استعمال ہونے والے لنک کے ذریعے ای میل کیا جاتا ہے۔ بیس URL وہی — dt_live_ کلید سے دستخط شدہ درخواستیں لائیو فراہم کنندگان تک پہنچتی ہیں اور ان کا تصفیہ آپ کے ڈپازٹ سے ہوتا ہے؛ آپ کی سینڈ باکس کلید جانچ کے لیے کام کرتی رہتی ہے۔