Tezkor boshlash

1. Sandbox hisob maʼlumotlarini oling

Sayohat APIʼlari sahifasida roʻyxatdan oʻting. Elektron pochtangiz tasdiqlangach, hamkor hisobingiz yaratiladi va ekranda sandbox kalit ID si koʻrsatiladi; maxfiy kalit esa shu manzilga yuboriladigan bir martalik ochish havolasi orqali yetkaziladi. Uni maxfiy maʼlumotlar menejeringizda saqlang — u faqat bir marta koʻrsatiladi.

Shuningdek, dasturchi portali uchun vaqtinchalik parol olasiz: u yerda kalitlarni yaratish va almashtirish, IP ruxsat roʻyxatini belgilash, foydalanishni kuzatish va production soʻrash mumkin.

2. Har bir soʻrovni imzolang

Har bir chaqiruv toʻrtta sarlavhaga ega: X-API-Key (kalit ID ingiz), X-Timestamp (unix soniyalar), X-Nonce (16–128 ta tasodifiy belgi) va X-Signature — maxfiy kalitingiz bilan hisoblangan kanonik satrning kichik harfli hex HMAC-SHA256 qiymati.

Kanonik satr yangi qator belgisi bilan birlashtirilgan besh qatordan iborat: katta harflardagi HTTP metodi, yuborilgandek aynan yoʻl va soʻrov satri, vaqt tamgʻasi, nonce hamda xom tananing kichik harfli hex SHA-256 qiymati (boʻsh tana nol baytning SHA-256 qiymati sifatida xeshlanadi). Vaqt tamgʻalari bizning soatimizdan 300 soniyadan ortiq farq qilmasligi kerak; nonce 10 daqiqa ichida faqat bir marta ishlatilishi mumkin.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Birinchi chaqiruvingizni bajaring

Sandbox muhitida reys qidirib koʻring. Sandbox yetkazib beruvchilarimizning sinov muhitlariga ulangan, shuning uchun qidiruvlar sinov inventari va narxlarini qaytaradi, u yerda qilingan bron esa sinov broni boʻladi — haqiqiy chipta ham, toʻlov ham yoʻq. Har bir maʼlumotnoma sahifasida cURL, Node.js, Python va PHP dagi toʻliq namuna bor — uni nusxalang, kalit ID va maxfiy kalitingizni kiriting va ishga tushiring.

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. Bron oqimini yakunlang

Parvozlar: qidiruv → tanlangan taklifni narxlash → yoʻlovchilar va aloqa maʼlumotlari bilan buyurtma yaratish → chiptani rasmiylashtirish → (ixtiyoriy) qaytarish narxini olish va qaytarishni soʻrash. Mehmonxonalar: qidiruv → obyekt xonalarini oʻqish → narxni tekshirish → bron yaratish → (ixtiyoriy) bekor qilish narxini olish va bekor qilish.

Taklif ID lari va narx kalitlari shaffof emas va qisqa muddatli. Majburiyat olishdan oldin har doim narxlang yoki tekshiring: agar narx oʻzgargan boʻlsa, yangi summa bilan 409 price_changed olasiz va qarorni oʻzingiz qabul qilasiz.

5. Production soʻrang

Integratsiyangiz sandboxʼda oqimni boshidan oxirigacha bajargach, dasturchi portalini oching va production soʻrang. Biz sandbox faoliyatini (qidiruvlar, buyurtma, bron, bekor qilish) va integratsiya tafsilotlaringizni koʻrib chiqamiz, soʻng hisobingizni oʻtkazamiz: production kalit juftligi oʻsha bir martalik ochish havolasi orqali elektron pochtaga yuboriladi. Asosiy URL oʻsha — dt_live_ kaliti bilan imzolangan soʻrovlar jonli yetkazib beruvchilarga boradi va depozitingiz hisobidan hisob-kitob qilinadi; sandbox kalitingiz test uchun ishlashda davom etadi.