Környezetek, korlátok és verziókezelés

Tesztkörnyezet és éles környezet, egy alap URL

Alap URL: https://api.dubaitrip.com/v1. A tesztkörnyezet és az éles környezet közösen használja; az aláíráshoz használt kulcs választja ki a környezetet. A dt_sbx_ kulcs beszállítóink tesztkörnyezetein fut — a keresés, árazás, árellenőrzés, rendelés, foglalás, jegykiállítás és lemondás mind végigfut a tesztkínálaton, valódi jegy vagy voucher és bármilyen terhelés nélkül. Az éles ellenőrzés után kiadott dt_live_ kulcs az élő kínálatot éri el, és a letétjéből számol el.

A tesztkörnyezeti és az éles foglalások külön jelennek meg a fejlesztői portálon (minden foglalás meg van jelölve), a hatóköröket, korlátokat és IP-szabályokat pedig környezetenként kezeljük.

Sebességkorlátok és kvóták

Minden kulcsot egy token bucket (tartós kérésszám másodpercenként plusz burst) és egy napi kvóta korlátoz. Tesztkörnyezeti alapértékek: 2 kérés/másodperc, burst 5, 2000 kérés/nap. Az éles korlátokat fiókonként egyeztetjük. A bucket túllépésekor a válasz 429 api_rate_limited Retry-After fejléccel; a kvóta kimerülésekor 429 api_quota_exceeded éjfélig (UTC).

A nehéz keresések eleve aszinkronok: adja meg a wait=false értéket, hogy azonnal kapjon egy searchId-t, és kérdezze le ismételten a keresési végpontot, vagy a wait=true értéket, hogy egyetlen hívásban megkapja a teljes eredményt. A lekérdezések ugyanúgy beszámítanak a korlátokba, mint bármely más kérés.

Look-to-book korlát

A kereséseket a foglalásai arányában is adagoljuk. Egy gördülő időablak (alapértelmezés szerint 7 nap) minden napja ingyenes keresési keretet ad, és az ablakban létrejött minden foglalás további cap számú keresést ad hozzá — a cap a fiókjára egyeztetett, foglalásonkénti keresésszám, amely a fejlesztői portálon látható. A lekérdezések, az árazás, a viteldíjszabályok és a tartalomolvasás sosem számít bele; csak a repülőjegy- és szálláskeresési hívások.

Ha a keret elfogyott, a keresések 429 look_to_book_exceeded választ kapnak egy Retry-After fejléccel, amely a következő UTC éjfélre mutat, amikor az ablak legrégebbi napja kiesik. Egy foglalás azonnal újranyitja a keretet. A fejlesztői portál Look-to-book kártyája mutatja az élő számlálókat, a cap értékét és a fennmaradó keretet; ha integrációja jogosan sokkal többet keres, mint amennyit foglal, kérje a cap emelését ahelyett, hogy az elutasítás ellenére újrapróbálkozna.

Idempotencia

A pénzt vagy kínálatot lekötő végpontok — rendelés vagy foglalás létrehozása, kiállítás, lemondás — Idempotency-Key fejlécet igényelnek (bármilyen egyedi, legfeljebb 128 karakteres karakterlánc, ideális egy UUID). Ugyanazzal a kulccsal újrapróbálva az eredeti választ kapja vissza duplikátum létrehozása helyett; újrahasznált kulccsal küldött eltérő törzsre 409 a válasz.

Verziókezelés

A verzió az útvonalban szerepel (/v1). A bővítő jellegű változások — új opcionális mezők, új enum-értékek, új végpontok — verzióváltás nélkül jelennek meg, ezért elemezzen óvatosan, és hagyja figyelmen kívül az ismeretlen mezőket. A kompatibilitást megtörő változások új főverziót kapnak átállási időszakkal; a Változásnapló útmutató minden változást felsorol.