شروع سریع

1. اطلاعات دسترسی محیط آزمایشی را بگیرید

در صفحهٔ رابط‌های برنامه‌نویسی سفر ثبت‌نام کنید. پس از تأیید ایمیل، حساب شریک شما ساخته می‌شود و یک شناسه کلید محیط آزمایشی روی صفحه نمایش داده می‌شود؛ کلید مخفی از طریق یک لینک نمایش یک‌بارمصرف به همان نشانی فرستاده می‌شود. آن را در مدیر اسرار خود نگه دارید — دقیقاً یک بار نمایش داده می‌شود.

یک رمز عبور موقت هم برای پورتال توسعه‌دهندگان دریافت می‌کنید؛ آن‌جا می‌توانید کلید بسازید و بچرخانید، فهرست IPهای مجاز تعیین کنید، مصرف را ببینید و محیط عملیاتی را درخواست کنید.

2. هر درخواست را امضا کنید

هر فراخوانی چهار هدر دارد: X-API-Key (شناسه کلید شما)، X-Timestamp (ثانیه‌های یونیکس)، X-Nonce (16 تا 128 نویسهٔ تصادفی) و X-Signature — مقدار HMAC-SHA256 یک رشتهٔ متعارف به‌صورت هگز با حروف کوچک، که با کلید مخفی شما محاسبه می‌شود.

رشته متعارف پنج خط است که با کاراکتر خط جدید به هم وصل می‌شوند: متد HTTP با حروف بزرگ، مسیر به‌همراه کوئری استرینگ دقیقاً همان‌طور که ارسال می‌شود، مُهر زمانی، nonce، و SHA-256 بدنه خام به‌صورت هگز با حروف کوچک (هش بدنه خالی برابر 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_ امضا شوند به تأمین‌کنندگان واقعی می‌رسند و از سپرده شما تسویه می‌شوند؛ کلید محیط آزمایشی شما برای تست همچنان کار می‌کند.