Okruženja, ograničenja i verzije

Sandbox i produkcija, jedan osnovni URL

Osnovni URL: https://api.dubaitrip.com/v1. Sandbox i produkcija ga dele; ključ kojim potpisujete bira okruženje. dt_sbx_ ključ radi sa test okruženjima naših dobavljača — pretrage, obračun cena, provere cena, porudžbine, rezervacije, izdavanje karata i otkazivanja rade od početka do kraja na test ponudi, bez prave karte ili vaučera i bez ikakve naplate. dt_live_ ključ, izdat nakon provere za produkciju, pristupa stvarnoj ponudi i naplaćuje se iz vašeg depozita.

Sandbox i produkcione rezervacije se na vašem portalu za programere drže odvojeno (svaka rezervacija je označena), a opsezi, ograničenja i IP pravila upravljaju se posebno za svako okruženje.

Ograničenja broja zahteva i kvote

Svaki ključ je ograničen kantom tokena (stalni broj zahteva u sekundi plus nalet) i dnevnom kvotom. Podrazumevane sandbox vrednosti: 2 zahteva/sekund, nalet 5, 2.000 zahteva/dan. Produkciona ograničenja se dogovaraju po nalogu. Prekoračenje kante vraća 429 api_rate_limited sa zaglavljem Retry-After; iscrpljivanje kvote vraća 429 api_quota_exceeded do ponoći po UTC.

Zahtevne pretrage su namerno asinhrone: pošaljite wait=false da odmah dobijete searchId i periodično proveravate krajnju tačku pretrage, ili wait=true da dobijete kompletan rezultat u jednom pozivu. Periodične provere se računaju u vaša ograničenja kao i svaki drugi zahtev.

Zaštita odnosa pretraga i rezervacija

Pretrage se raspoređuju i u odnosu na rezervacije koje napravite. Svaki dan kliznog perioda (podrazumevano 7 dana) donosi besplatan broj pretraga, a svaka rezervacija napravljena u tom periodu dodaje još cap pretraga — cap je broj pretraga po rezervaciji dogovoren za vaš nalog i prikazan na portalu za programere. Periodične provere, obračun cena, pravila tarifa i čitanje sadržaja nikada se ne računaju; računaju se samo pozivi pretrage letova i hotela.

Kada se dozvoljeni broj potroši, pretrage vraćaju 429 look_to_book_exceeded sa zaglavljem Retry-After koje upućuje na sledeću ponoć po UTC, kada najstariji dan perioda ispada. Rezervacija odmah ponovo otvara dozvoljeni broj. Kartica Odnos pretraga i rezervacija na portalu za programere prikazuje brojače uživo, ograničenje i preostali broj; ako vaša integracija opravdano pretražuje mnogo više nego što rezerviše, zamolite nas da povećamo ograničenje umesto da ponavljate zahteve uprkos odbijanju.

Idempotentnost

Krajnje tačke koje angažuju novac ili ponudu — kreiranje porudžbine ili rezervacije, izdavanje, otkazivanje — zahtevaju zaglavlje Idempotency-Key (bilo koji jedinstveni string do 128 znakova, UUID je idealan). Ponovni pokušaj sa istim ključem vraća originalni odgovor umesto da napravi duplikat; drugačije telo pod ponovo upotrebljenim ključem vraća 409.

Verzije

Verzija je u putanji (/v1). Dodatne izmene — nova opciona polja, nove enum vrednosti, nove krajnje tačke — objavljuju se bez promene verzije, pa parsirajte oprezno i zanemarite nepoznata polja. Izmene koje narušavaju kompatibilnost dobijaju novu glavnu verziju sa periodom za migraciju; vodič Dnevnik izmena navodi svaku izmenu.