Miljøer, grenser og versjonering

Sandkasse og produksjon, én basis-URL

Basis-URL: https://api.dubaitrip.com/v1. Sandkasse og produksjon deler den; nøkkelen du signerer med, velger miljøet. En dt_sbx_-nøkkel kjører mot leverandørenes testmiljøer – søk, prising, priskontroller, ordrer, bestillinger, billettutstedelse og kanselleringer fungerer fra start til slutt på testbeholdning, uten ekte billett eller kupong og uten belastning. En dt_live_-nøkkel, utstedt etter produksjonsgjennomgangen, når den faktiske beholdningen og gjøres opp mot depositumet ditt.

Sandkasse- og produksjonsbestillinger holdes atskilt i utviklerportalen din (hver bestilling er merket), og tilganger, grenser og IP-regler administreres per miljø.

Hastighetsgrenser og kvoter

Hver nøkkel strupes av en tokenbøtte (vedvarende forespørsler per sekund pluss en topp) og en daglig kvote. Standardverdier i sandkassen: 2 forespørsler/sekund, topp 5, 2 000 forespørsler/dag. Produksjonsgrenser avtales per konto. Overskrides bøtten, svarer API-et 429 api_rate_limited med en Retry-After-header; er kvoten brukt opp, svarer det 429 api_quota_exceeded frem til midnatt UTC.

Tunge søk er asynkrone med vilje: send wait=false for å få en searchId umiddelbart og polle søkeendepunktet, eller wait=true for å få hele resultatet i ett kall. Polling teller mot grensene dine som alle andre forespørsler.

Look-to-book-sperre

Søk rasjoneres også mot bestillingene du gjør. Hver dag i en rullerende periode (7 dager som standard) gir en gratis søkekvote, og hver bestilling i den perioden legger til ytterligere cap søk – cap er antallet søk per bestilling som er avtalt for kontoen din og vises i utviklerportalen. Polling, prising, prisregler og innholdsoppslag teller aldri; bare søkekall for fly og hotell gjør det.

Når kvoten er brukt opp, svarer søk med 429 look_to_book_exceeded og en Retry-After-header som peker på neste midnatt UTC, når den eldste dagen i perioden faller ut. En bestilling åpner kvoten igjen umiddelbart. Look-to-book-kortet i utviklerportalen viser tellerne i sanntid, grensen og hva som gjenstår; hvis integrasjonen din av gode grunner søker langt mer enn den bestiller, be oss heve grensen i stedet for å prøve på nytt gjennom avvisningen.

Idempotens

Endepunkter som forplikter penger eller beholdning – oppretting av ordre eller bestilling, utstedelse, kansellering – krever en Idempotency-Key-header (en hvilken som helst unik streng på opptil 128 tegn; en UUID er ideelt). Nytt forsøk med samme nøkkel returnerer det opprinnelige svaret i stedet for å opprette et duplikat; en annen forespørselstekst under en gjenbrukt nøkkel gir 409.

Versjonering

Versjonen står i stien (/v1). Tillegg – nye valgfrie felt, nye enum-verdier, nye endepunkter – lanseres uten versjonsøkning, så parse defensivt og ignorer ukjente felt. Endringer som bryter kompatibiliteten, får en ny hovedversjon med en overgangsperiode; veiledningen Endringslogg viser alle endringer.