Miljöer, gränser och versionshantering

Sandbox och produktion, en bas-URL

Bas-URL: https://api.dubaitrip.com/v1. Sandbox och produktion delar den; nyckeln du signerar med väljer miljön. En dt_sbx_-nyckel körs mot våra leverantörers testmiljöer – sökningar, prissättning, priskontroller, ordrar, bokningar, biljettutfärdande och avbokningar fungerar hela vägen på testutbud, utan riktig biljett eller voucher och utan debitering. En dt_live_-nyckel, som utfärdas efter produktionsgranskningen, når det skarpa utbudet och avräknas mot din deposition.

Bokningar i sandbox och produktion hålls isär i din utvecklarportal (varje bokning är märkt), och behörigheter, gränser och IP-regler hanteras per miljö.

Anropsgränser och kvoter

Varje nyckel stryps av en token bucket (varaktiga anrop per sekund plus en burst) och en daglig kvot. Standardvärden i sandbox: 2 anrop/sekund, burst 5, 2 000 anrop/dag. Gränserna i produktion avtalas per konto. Överskrids bucketen blir svaret 429 api_rate_limited med ett Retry-After-huvud; är kvoten förbrukad blir svaret 429 api_quota_exceeded fram till midnatt UTC.

Tunga sökningar är asynkrona till sin utformning: skicka wait=false för att direkt få ett searchId och polla sökändpunkten, eller wait=true för att få hela resultatet i ett anrop. Pollning räknas mot dina gränser som alla andra anrop.

Look-to-book-spärr

Sökningar ransoneras också i förhållande till de bokningar du gör. Varje dag i ett rullande tidsfönster (7 dagar som standard) ger en kostnadsfri kvot av sökningar, och varje bokning som görs i det fönstret lägger till ytterligare cap sökningar – cap är antalet sökningar per bokning som avtalats för ditt konto och som visas i utvecklarportalen. Pollning, prissättning, prisregler och innehållsläsningar räknas aldrig; bara sökanrop för flyg och hotell räknas.

När kvoten är förbrukad svarar sökningar med 429 look_to_book_exceeded och ett Retry-After-huvud som pekar på nästa midnatt UTC, då den äldsta dagen faller ur fönstret. En bokning öppnar kvoten igen direkt. Look-to-book-kortet i utvecklarportalen visar de aktuella räknarna, taket och vad som återstår; om din integration av legitima skäl söker betydligt mer än den bokar, be oss höja taket i stället för att försöka igen trots avvisningen.

Idempotens

Ändpunkter som binder pengar eller utbud – skapa en order eller bokning, utfärda, avboka – kräver ett Idempotency-Key-huvud (valfri unik sträng på upp till 128 tecken, ett UUID är idealiskt). Ett nytt försök med samma nyckel returnerar det ursprungliga svaret i stället för att skapa en dubblett; en annan kropp under en återanvänd nyckel besvaras med 409.

Versionshantering

Versionen ligger i sökvägen (/v1). Tillägg – nya valfria fält, nya enum-värden, nya ändpunkter – levereras utan versionsbyte, så tolka defensivt och ignorera okända fält. Bakåtinkompatibla ändringar får en ny huvudversion med en migreringsperiod; guiden Ändringslogg listar varje ändring.