Rýchly štart

1. Získajte prístupové údaje do sandboxu

Zaregistrujte sa na stránke Cestovné API. Po overení e-mailu vznikne váš partnerský účet a na obrazovke sa zobrazí ID kľúča do sandboxu; tajný kľúč príde cez jednorazový odkaz na odhalenie na tú istú adresu. Uložte si ho do správcu tajomstiev — zobrazí sa presne raz.

Dostanete aj dočasné heslo do portálu pre vývojárov, kde môžete vytvárať a rotovať kľúče, nastaviť zoznam povolených IP, sledovať využitie a požiadať o produkciu.

2. Podpisujte každú požiadavku

Každé volanie obsahuje štyri hlavičky: X-API-Key (ID vášho kľúča), X-Timestamp (unixové sekundy), X-Nonce (16–128 náhodných znakov) a X-Signature — HMAC-SHA256 kanonického reťazca v hex zápise malými písmenami, vypočítaný s vaším tajným kľúčom.

Kanonický reťazec tvorí päť riadkov spojených znakom nového riadku: HTTP metóda veľkými písmenami, cesta spolu s query reťazcom presne tak, ako boli odoslané, časová pečiatka, nonce a SHA-256 surového tela v hex zápise malými písmenami (prázdne telo sa hashuje ako SHA-256 nula bajtov). Časové pečiatky sa od našich hodín môžu líšiť najviac o 300 sekúnd; nonce možno použiť iba raz v priebehu 10 minút.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Urobte prvé volanie

Vyhľadajte let v sandboxe. Sandbox je napojený na testovacie prostredia našich dodávateľov, takže vyhľadávanie vracia testovaciu ponuku a ceny a rezervácia v ňom vytvorená je testovacia — žiadna skutočná letenka, žiadna platba. Každá referenčná stránka obsahuje kompletnú ukážku v cURL, Node.js, Python a PHP — skopírujte ju, doplňte ID kľúča a tajný kľúč a spustite.

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. Dokončite rezervačný tok

Lety: vyhľadávanie → ocenenie zvolenej ponuky → vytvorenie objednávky s cestujúcimi a kontaktom → vystavenie letenky → (voliteľne) kalkulácia a žiadosť o refundáciu. Hotely: vyhľadávanie → načítanie izieb ubytovania → kontrola sadzby → vytvorenie rezervácie → (voliteľne) kalkulácia a zrušenie.

ID ponúk a kľúče sadzieb sú neprehľadné (opaque) a majú krátku platnosť. Vždy ocenenie alebo kontrolu urobte tesne pred potvrdením: ak sa cena zmenila, dostanete 409 price_changed s novou sumou a rozhodnete sa sami.

5. Požiadajte o produkciu

Keď vaša integrácia v sandboxe prejde celým tokom od začiatku do konca, otvorte portál pre vývojárov a požiadajte o produkciu. Skontrolujeme aktivitu v sandboxe (vyhľadávania, objednávku, rezerváciu, zrušenie) a detaily integrácie a potom váš účet prepneme: produkčný pár kľúčov vám pošleme cez rovnaký jednorazový odkaz na odhalenie. Základná URL zostáva rovnaká — požiadavky podpísané kľúčom dt_live_ smerujú k ostrým dodávateľom a zúčtujú sa voči vašej zálohe; kľúč do sandboxu funguje ďalej na testovanie.