Prostředí, limity a verzování

Testovací prostředí a produkce, jedna základní URL

Základní URL: https://api.dubaitrip.com/v1. Testovací prostředí i produkce ji sdílejí; prostředí určuje klíč, kterým podepisujete. Klíč dt_sbx_ pracuje proti testovacím prostředím našich dodavatelů — vyhledávání, ocenění, kontroly cen, objednávky, rezervace, vystavování letenek i storna fungují od začátku do konce na testovací nabídce, bez skutečné letenky či voucheru a bez jakýchkoli poplatků. Klíč dt_live_, vydaný po posouzení pro produkci, míří na živou nabídku a zúčtovává se proti vaší záloze.

Rezervace z testovacího prostředí a z produkce jsou ve vývojářském portálu oddělené (každá rezervace je označena) a oprávnění, limity i pravidla IP se spravují pro každé prostředí zvlášť.

Limity požadavků a kvóty

Každý klíč je omezen metodou token bucket (trvalý počet požadavků za sekundu plus špička) a denní kvótou. Výchozí hodnoty testovacího prostředí: 2 požadavky/sekundu, špička 5, 2 000 požadavků/den. Produkční limity se sjednávají pro každý účet. Při překročení bucketu přijde odpověď 429 api_rate_limited s hlavičkou Retry-After; po vyčerpání kvóty přichází 429 api_quota_exceeded až do půlnoci UTC.

Náročná vyhledávání jsou záměrně asynchronní: pošlete wait=false a ihned získáte searchId, se kterým se dotazujete na endpoint vyhledávání, nebo wait=true a kompletní výsledek dostanete jedním voláním. Dotazování (polling) se do limitů započítává jako každý jiný požadavek.

Ochrana poměru look-to-book

Vyhledávání je také přidělováno podle rezervací, které provádíte. Každý den klouzavého okna (ve výchozím stavu 7 dní) přináší bezplatný příděl vyhledávání a každá rezervace provedená v tomto okně k němu přidá dalších cap vyhledávání — cap je počet vyhledávání na rezervaci sjednaný pro váš účet a zobrazený ve vývojářském portálu. Dotazování (polling), ocenění, tarifní pravidla a čtení obsahu se nikdy nezapočítávají; počítají se jen volání vyhledávání letů a hotelů.

Po vyčerpání přídělu odpovídá vyhledávání 429 look_to_book_exceeded s hlavičkou Retry-After ukazující na nejbližší půlnoc UTC, kdy nejstarší den okna vypadne. Rezervace příděl okamžitě znovu otevře. Karta Look-to-book ve vývojářském portálu ukazuje živá počítadla, limit a zbývající příděl; pokud vaše integrace oprávněně vyhledává mnohem víc, než rezervuje, požádejte nás o zvýšení limitu, místo abyste přes odmítnutí opakovali pokusy.

Idempotence

Endpointy, které závazně pracují s penězi nebo nabídkou — vytvoření objednávky či rezervace, vystavení, storno — vyžadují hlavičku Idempotency-Key (libovolný jedinečný řetězec do 128 znaků, ideálně UUID). Opakovaný pokus se stejným klíčem vrátí původní odpověď místo vytvoření duplikátu; jiné tělo pod znovu použitým klíčem vrátí 409.

Verzování

Verze je v cestě (/v1). Rozšiřující změny — nová volitelná pole, nové hodnoty výčtů, nové endpointy — vycházejí bez zvýšení verze, proto parsujte defenzivně a neznámá pole ignorujte. Nekompatibilní změny dostanou novou hlavní verzi s přechodným obdobím; návod Přehled změn uvádí každou změnu.