Rychlý start

1. Získejte přístupové údaje do testovacího prostředí

Zaregistrujte se na stránce Cestovní API. Jakmile je váš e-mail ověřen, vznikne váš partnerský účet a na obrazovce se zobrazí ID klíče do testovacího prostředí; tajný klíč vám přijde jednorázovým odkazem na stejnou adresu. Uložte jej do svého správce tajných klíčů — zobrazí se přesně jednou.

Dostanete také dočasné heslo do vývojářského portálu, kde můžete vytvářet a obměňovat klíče, nastavit seznam povolených IP adres, sledovat využití a požádat o produkci.

2. Podepisujte každý požadavek

Každé volání nese čtyři hlavičky: X-API-Key (ID vašeho klíče), X-Timestamp (unixové sekundy), X-Nonce (16–128 náhodných znaků) a X-Signature — HMAC-SHA256 kanonického řetězce v hexadecimálním zápisu malými písmeny, s vaším tajným klíčem jako klíčem.

Kanonický řetězec tvoří pět řádků spojených znakem nového řádku: metoda HTTP velkými písmeny, cesta včetně řetězce dotazu přesně tak, jak byla odeslána, časové razítko, nonce a SHA-256 surového těla v hexadecimálním zápisu malými písmeny (prázdné tělo má hash SHA-256 z nula bajtů). Časová razítka se smějí od našich hodin lišit nejvýše o 300 sekund; nonce lze v rámci 10 minut použít jen jednou.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Proveďte první volání

Vyhledejte let v sandboxu. Sandbox je napojen na testovací prostředí našich dodavatelů, takže vyhledávání vrací testovací nabídku a ceny a rezervace v něm vytvořená je testovací — žádná skutečná letenka, žádná platba. Každá referenční stránka obsahuje kompletní ukázku v cURL, Node.js, Python a PHP — zkopírujte ji, doplňte ID klíče a tajný klíč a spusťte.

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čete rezervační průběh

Lety: vyhledání → ocenění vybrané nabídky → vytvoření objednávky s cestujícími a kontaktem → vystavení letenky → (volitelně) kalkulace a žádost o refundaci. Hotely: vyhledání → načtení pokojů ubytování → kontrola ceny → vytvoření rezervace → (volitelně) kalkulace a storno.

ID nabídek a klíče cen jsou neprůhledné a krátkodobé. Vždy ověřte cenu těsně před závazným krokem: pokud se cena změnila, obdržíte 409 price_changed s novou částkou a rozhodnutí je na vás.

5. Požádejte o produkci

Jakmile vaše integrace projde v testovacím prostředí celým průběhem od začátku do konce, otevřete vývojářský portál a požádejte o produkci. Posoudíme aktivitu v testovacím prostředí (vyhledávání, objednávku, rezervaci, storno) a podrobnosti vaší integrace a poté váš účet převedeme: produkční pár klíčů vám zašleme e-mailem stejným jednorázovým odkazem. Základní URL zůstává stejná — požadavky podepsané klíčem dt_live_ míří na živé dodavatele a zúčtovávají se proti vaší záloze; klíč do testovacího prostředí vám dál funguje pro testování.