Sürətli başlanğıc

1. Sandbox giriş məlumatlarını əldə edin

Səyahət API-ləri səhifəsində qeydiyyatdan keçin. E-poçtunuz təsdiqləndikdən sonra tərəfdaş hesabınız yaranır və ekranda sandbox açar ID-si göstərilir; gizli açar isə həmin ünvana göndərilən birdəfəlik göstərmə linki ilə çatdırılır. Onu sirlər menecerinizdə saxlayın — o, düz bir dəfə göstərilir.

Siz həmçinin tərtibatçı portalı üçün müvəqqəti parol alırsınız; orada açarlar yarada və dəyişdirə, IP icazə siyahısı təyin edə, istifadəni izləyə və production tələb edə bilərsiniz.

2. Hər sorğunu imzalayın

Hər çağırış dörd başlıq daşıyır: X-API-Key (açar ID-niz), X-Timestamp (unix saniyələri), X-Nonce (16–128 təsadüfi simvol) və X-Signature — gizli açarınızla açarlanmış kanonik sətrin kiçik hərfli hex HMAC-SHA256 dəyəri.

Kanonik sətir yeni sətir simvolu ilə birləşdirilmiş beş sətirdən ibarətdir: böyük hərflərlə HTTP metodu, göndərildiyi kimi dəqiq yol və sorğu sətri, timestamp, nonce və xam gövdənin kiçik hərfli hex SHA-256 dəyəri (boş gövdə sıfır baytın SHA-256 dəyəri kimi hesablanır). Timestamp saatımızdan 300 saniyədən çox fərqlənməməlidir; nonce 10 dəqiqə ərzində yalnız bir dəfə istifadə edilə bilər.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. İlk çağırışınızı edin

Sandbox mühitində uçuş axtarın. Sandbox təchizatçılarımızın test mühitlərinə qoşulub, ona görə axtarışlar test inventarı və qiymətləri qaytarır, orada edilən rezervasiya isə test rezervasiyasıdır — real bilet də, ödəniş də yoxdur. Hər istinad səhifəsində cURL, Node.js, Python və PHP-də tam nümunə var — onu kopyalayın, açar ID-nizi və gizli açarınızı daxil edin, işə salın.

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. Rezervasiya axınını tamamlayın

Uçuşlar: axtarış → seçilmiş təklifin qiymətləndirilməsi → sərnişinlər və əlaqə məlumatları ilə sifarişin yaradılması → biletin rəsmiləşdirilməsi → (istəyə bağlı) geri qaytarma qiymətinin alınması və geri qaytarma sorğusu. Otellər: axtarış → obyektin otaqlarının oxunması → tarifin yoxlanılması → rezervasiyanın yaradılması → (istəyə bağlı) ləğv qiymətinin alınması və ləğv.

Təklif ID-ləri və tarif açarları qeyri-şəffafdır və qısamüddətlidir. Təsdiqləməzdən dərhal əvvəl həmişə qiyməti yoxlayın: qiymət dəyişibsə, yeni məbləğlə 409 price_changed alırsınız və qərarı siz verirsiniz.

5. Production tələb edin

İnteqrasiyanız sandbox-da axını əvvəldən sona qədər tamamladıqda, tərtibatçı portalını açın və production tələb edin. Biz sandbox fəaliyyətini (axtarışlar, sifariş, rezervasiya, ləğv) və inteqrasiya təfərrüatlarınızı yoxlayır, sonra hesabınızı keçiririk: production açar cütü həmin birdəfəlik göstərmə linki ilə e-poçtla göndərilir. Baza URL eynidir — dt_live_ açarı ilə imzalanmış sorğular canlı təchizatçılara çatır və depozitinizdən hesablaşdırılır; sandbox açarınız isə test üçün işləməyə davam edir.