Prostredia, limity a verzovanie

Sandbox a produkcia, jedna základná URL

Základná URL: https://api.dubaitrip.com/v1. Sandbox aj produkcia ju zdieľajú; prostredie určuje kľúč, ktorým podpisujete. Kľúč dt_sbx_ pracuje s testovacími prostrediami našich dodávateľov — vyhľadávanie, ocenenie, kontrola sadzieb, objednávky, rezervácie, vystavenie leteniek aj zrušenia fungujú od začiatku do konca na testovacej ponuke, bez skutočnej letenky či poukazu a bez akéhokoľvek zúčtovania. Kľúč dt_live_, vydaný po kontrole pred produkciou, smeruje k ostrej ponuke a zúčtuje sa voči vašej zálohe.

Rezervácie zo sandboxu a z produkcie sú v portáli pre vývojárov oddelené (každá rezervácia je označená) a rozsahy, limity aj pravidlá IP sa spravujú pre každé prostredie zvlášť.

Limity požiadaviek a kvóty

Každý kľúč je obmedzený algoritmom token bucket (trvalý počet požiadaviek za sekundu plus špička) a dennou kvótou. Predvolené hodnoty sandboxu: 2 požiadavky/sekundu, špička 5, 2000 požiadaviek/deň. Produkčné limity sa dohodnú pre každý účet. Prekročenie bucketu vráti 429 api_rate_limited s hlavičkou Retry-After; vyčerpanie kvóty vracia 429 api_quota_exceeded až do polnoci UTC.

Náročné vyhľadávania sú zámerne asynchrónne: pošlite wait=false, aby ste hneď dostali searchId a dopytovali endpoint vyhľadávania, alebo wait=true, aby ste dostali úplný výsledok jedným volaním. Dopytovanie sa započítava do limitov ako každá iná požiadavka.

Ochrana look-to-book

Vyhľadávania sú navyše prideľované podľa rezervácií, ktoré urobíte. Každý deň kĺzavého obdobia (predvolene 7 dní) prináša bezplatný limit vyhľadávaní a každá rezervácia urobená v tomto období pridá ďalších cap vyhľadávaní — cap je počet vyhľadávaní na rezerváciu dohodnutý pre váš účet a zobrazený v portáli pre vývojárov. Dopytovanie, ocenenie, tarifné pravidlá a čítanie obsahu sa nikdy nezapočítavajú; počítajú sa iba volania vyhľadávania letov a hotelov.

Po vyčerpaní limitu vyhľadávania vracajú 429 look_to_book_exceeded s hlavičkou Retry-After, ktorá ukazuje na najbližšiu polnoc UTC, keď najstarší deň obdobia vypadne. Rezervácia limit okamžite znovu otvorí. Karta Look-to-book v portáli pre vývojárov ukazuje aktuálne počítadlá, cap a zostávajúci počet; ak vaša integrácia oprávnene vyhľadáva oveľa viac, než rezervuje, požiadajte nás o zvýšenie cap, namiesto opakovania požiadaviek napriek odmietnutiu.

Idempotencia

Endpointy, ktoré viažu peniaze alebo kapacity — vytvorenie objednávky či rezervácie, vystavenie, zrušenie — vyžadujú hlavičku Idempotency-Key (ľubovoľný jedinečný reťazec do 128 znakov, ideálne UUID). Opakovanie s rovnakým kľúčom vráti pôvodnú odpoveď namiesto vytvorenia duplikátu; iné telo pod opätovne použitým kľúčom vráti 409.

Verzovanie

Verzia je v ceste (/v1). Doplňujúce zmeny — nové nepovinné polia, nové hodnoty enum, nové endpointy — vychádzajú bez zmeny verzie, preto odpovede spracúvajte defenzívne a neznáme polia ignorujte. Nekompatibilné zmeny dostanú novú hlavnú verziu s obdobím na migráciu; všetky zmeny uvádza návod Zoznam zmien.