Ympäristöt, rajat ja versiointi

Sandbox ja tuotanto, yksi perus-URL

Perus-URL: https://api.dubaitrip.com/v1. Sandbox ja tuotanto jakavat sen; allekirjoitukseen käyttämäsi avain valitsee ympäristön. dt_sbx_-avain toimii toimittajiemme testiympäristöjä vasten – haut, hinnoittelu, hintatarkistukset, tilaukset, varaukset, lipunkirjoitus ja peruutukset toimivat kaikki alusta loppuun testitarjonnalla, ilman oikeaa lippua tai voucheria ja ilman veloituksia. Tuotantotarkistuksen jälkeen myönnetty dt_live_-avain ohjautuu todelliseen tarjontaan ja veloitetaan talletuksestasi.

Sandbox- ja tuotantovaraukset pidetään kehittäjäportaalissasi erillään (jokainen varaus on merkitty), ja käyttöoikeuksia, rajoja ja IP-sääntöjä hallitaan ympäristökohtaisesti.

Pyyntörajat ja kiintiöt

Jokaista avainta rajoittaa token bucket (jatkuvat pyynnöt sekunnissa sekä purske) ja päiväkiintiö. Sandboxin oletukset: 2 pyyntöä/sekunti, purske 5, 2 000 pyyntöä/päivä. Tuotannon rajoista sovitaan tilikohtaisesti. Rajan ylitys palauttaa 429 api_rate_limited Retry-After-otsakkeen kera; kiintiön loppuminen palauttaa 429 api_quota_exceeded UTC-keskiyöhön asti.

Raskaat haut ovat suunnitellusti asynkronisia: anna wait=false, niin saat searchId:n heti ja voit kysellä hakupäätepistettä, tai wait=true, niin saat täydellisen tuloksen yhdellä kutsulla. Kyselyt lasketaan rajoihisi kuten mikä tahansa muu pyyntö.

Look-to-book-rajoitin

Hakuja säännöstellään myös tekemiesi varausten mukaan. Jokainen liukuvan jakson (oletuksena 7 päivää) päivä antaa ilmaisen hakukiintiön, ja jokainen jakson aikana tehty varaus lisää siihen vielä cap hakua – cap on tilillesi sovittu hakujen määrä varausta kohden, ja se näkyy kehittäjäportaalissa. Kyselyt, hinnoittelu, hintasäännöt ja sisällön luku eivät koskaan laske; vain lento- ja hotellihakukutsut lasketaan.

Kun kiintiö on käytetty, haut palauttavat 429 look_to_book_exceeded Retry-After-otsakkeen kera, joka osoittaa seuraavaan UTC-keskiyöhön, jolloin jakson vanhin päivä putoaa pois. Varaus avaa kiintiön heti uudelleen. Kehittäjäportaalin Look-to-book-suhde-kortti näyttää reaaliaikaiset laskurit, katon ja jäljellä olevan määrän; jos integraatiosi perustellusti hakee paljon enemmän kuin varaa, pyydä meitä nostamaan kattoa sen sijaan, että yrittäisit uudelleen hylkäyksestä huolimatta.

Idempotenssi

Päätepisteet, jotka sitovat rahaa tai tarjontaa – tilauksen tai varauksen luonti, lipunkirjoitus, peruutus – vaativat Idempotency-Key-otsakkeen (mikä tahansa yksilöllinen merkkijono, enintään 128 merkkiä; UUID on ihanteellinen). Uudelleenyritys samalla avaimella palauttaa alkuperäisen vastauksen kaksoiskappaleen luomisen sijaan; eri runko uudelleenkäytetyllä avaimella palauttaa 409.

Versiointi

Versio on polussa (/v1). Lisäävät muutokset – uudet valinnaiset kentät, uudet enum-arvot, uudet päätepisteet – julkaistaan ilman versionnostoa, joten jäsennä puolustavasti ja ohita tuntemattomat kentät. Rikkovat muutokset saavat uuden pääversion ja siirtymäajan; Muutosloki-opas luettelee jokaisen muutoksen.