Okruženja, ograničenja i verzije

Sandbox i produkcija, jedan osnovni URL

Osnovni URL: https://api.dubaitrip.com/v1. Sandbox i produkcija ga dijele; ključ kojim potpisujete odabire okruženje. Ključ dt_sbx_ radi prema testnim okruženjima naših dobavljača — pretraživanja, izračun cijena, provjere cijena, narudžbe, rezervacije, izdavanje karata i otkazivanja rade od početka do kraja na testnoj ponudi, bez stvarne karte ili vaučera i bez ikakve naplate. Ključ dt_live_, izdan nakon pregleda za produkciju, doseže stvarnu ponudu i podmiruje se iz vašeg depozita.

Sandbox i produkcijske rezervacije drže se odvojeno na vašem portalu za programere (svaka je rezervacija označena), a ovlastima, ograničenjima i IP pravilima upravlja se po okruženju.

Ograničenja učestalosti i kvote

Svaki je ključ ograničen token bucketom (trajni broj zahtjeva u sekundi plus nalet) i dnevnom kvotom. Zadane vrijednosti za sandbox: 2 zahtjeva/sekundi, nalet 5, 2.000 zahtjeva/dan. Produkcijska ograničenja dogovaraju se po računu. Prekoračenje bucketa vraća 429 api_rate_limited sa zaglavljem Retry-After; iscrpljivanje kvote vraća 429 api_quota_exceeded do ponoći po UTC-u.

Zahtjevna pretraživanja namjerno su asinkrona: pošaljite wait=false kako biste odmah dobili searchId i periodički provjeravali endpoint pretraživanja, ili wait=true kako biste potpuni rezultat dobili jednim pozivom. Periodičke provjere računaju se u vaša ograničenja kao i svaki drugi zahtjev.

Ograničenje look-to-book

Pretraživanja se raspodjeljuju i prema rezervacijama koje napravite. Svaki dan kliznog razdoblja (prema zadanome 7 dana) donosi besplatnu kvotu pretraživanja, a svaka rezervacija napravljena u tom razdoblju dodaje još cap pretraživanja — cap je broj pretraživanja po rezervaciji dogovoren za vaš račun i prikazan na portalu za programere. Periodičke provjere, izračun cijena, pravila tarife i čitanje sadržaja nikada se ne računaju; računaju se samo pozivi pretraživanja letova i hotela.

Kada se kvota potroši, pretraživanja vraćaju 429 look_to_book_exceeded sa zaglavljem Retry-After koje upućuje na sljedeću ponoć po UTC-u, kada najstariji dan razdoblja ispada. Rezervacija odmah ponovno otvara kvotu. Kartica Look-to-book na portalu za programere prikazuje brojače uživo, cap i ono što je preostalo; ako vaša integracija opravdano pretražuje daleko više nego što rezervira, zatražite od nas povećanje capa umjesto ponavljanja zahtjeva unatoč odbijanju.

Idempotentnost

Endpointi koji obvezuju novac ili ponudu — izrada narudžbe ili rezervacije, izdavanje, otkazivanje — zahtijevaju zaglavlje Idempotency-Key (bilo koji jedinstveni niz do 128 znakova; UUID je idealan). Ponovni pokušaj s istim ključem vraća izvorni odgovor umjesto izrade duplikata; drugačije tijelo pod ponovno upotrijebljenim ključem vraća 409.

Verzije

Verzija je u putanji (/v1). Dodatne promjene — nova neobavezna polja, nove enum vrijednosti, novi endpointi — objavljuju se bez promjene verzije, stoga parsirajte oprezno i zanemarite nepoznata polja. Promjene koje narušavaju kompatibilnost dobivaju novu glavnu verziju s razdobljem za migraciju; vodič Dnevnik promjena navodi svaku promjenu.