Omgevingen, limieten en versiebeheer

Sandbox en productie, één basis-URL

Basis-URL: https://api.dubaitrip.com/v1. Sandbox en productie delen deze; de sleutel waarmee u ondertekent, bepaalt de omgeving. Een dt_sbx_-sleutel draait tegen de testomgevingen van onze leveranciers — zoeken, prijzen, tariefcontroles, orders, boekingen, ticketuitgifte en annuleringen werken allemaal van begin tot eind op testaanbod, zonder echt ticket of voucher en zonder kosten. Een dt_live_-sleutel, uitgegeven na de productiebeoordeling, bereikt het live aanbod en wordt met uw deposito verrekend.

Sandbox- en productieboekingen worden in uw ontwikkelaarsportaal gescheiden gehouden (elke boeking is gemarkeerd), en scopes, limieten en IP-regels worden per omgeving beheerd.

Snelheidslimieten en quota

Elke sleutel wordt begrensd door een token bucket (aanhoudende verzoeken per seconde plus een burst) en een dagquotum. Sandbox-standaarden: 2 verzoeken/seconde, burst 5, 2.000 verzoeken/dag. Productielimieten worden per account afgesproken. Wie de bucket overschrijdt, krijgt 429 api_rate_limited met een Retry-After-header; wie het quotum opmaakt, krijgt 429 api_quota_exceeded tot middernacht UTC.

Zware zoekopdrachten zijn bewust asynchroon: geef wait=false mee om direct een searchId te krijgen en het zoek-endpoint te pollen, of wait=true om het volledige resultaat in één aanroep te ontvangen. Pollen telt mee voor uw limieten zoals elk ander verzoek.

Look-to-book-bewaking

Zoekopdrachten worden ook gerantsoeneerd op basis van de boekingen die u maakt. Elke dag van een voortschrijdend venster (standaard 7 dagen) geeft een gratis tegoed aan zoekopdrachten, en elke boeking in dat venster voegt daar nog eens cap zoekopdrachten aan toe — cap is het aantal zoekopdrachten per boeking dat voor uw account is afgesproken en in het ontwikkelaarsportaal wordt getoond. Polls, prijzen, tariefregels en het lezen van content tellen nooit mee; alleen zoekaanroepen voor vluchten en hotels.

Is het tegoed op, dan antwoorden zoekopdrachten met 429 look_to_book_exceeded en een Retry-After-header die naar de volgende middernacht UTC wijst, wanneer de oudste dag uit het venster valt. Een boeking opent het tegoed direct weer. De Look-to-book-kaart in het ontwikkelaarsportaal toont de live tellers, de limiet en wat er over is; zoekt uw integratie terecht veel meer dan ze boekt, vraag ons dan de limiet te verhogen in plaats van door de weigering heen te blijven proberen.

Idempotentie

Endpoints die geld of aanbod vastleggen — een order of boeking aanmaken, uitgeven, annuleren — vereisen een Idempotency-Key-header (een willekeurige unieke string van maximaal 128 tekens; een UUID is ideaal). Opnieuw proberen met dezelfde sleutel geeft de oorspronkelijke respons terug in plaats van een duplicaat aan te maken; een andere body onder een hergebruikte sleutel geeft 409.

Versiebeheer

De versie staat in het pad (/v1). Aanvullende wijzigingen — nieuwe optionele velden, nieuwe enum-waarden, nieuwe endpoints — worden uitgebracht zonder versieverhoging, dus parse defensief en negeer onbekende velden. Brekende wijzigingen krijgen een nieuwe hoofdversie met een migratieperiode; de handleiding Wijzigingslogboek vermeldt elke wijziging.