Muhitlar, limitlar va versiyalash

Sandbox va production, bitta asosiy URL

Asosiy URL: https://api.dubaitrip.com/v1. Sandbox va production undan birgalikda foydalanadi; muhitni siz imzolaydigan kalit tanlaydi. dt_sbx_ kaliti yetkazib beruvchilarimizning test muhitlarida ishlaydi — qidiruvlar, narxlash, narx tekshiruvlari, buyurtmalar, bronlar, chipta rasmiylashtirish va bekor qilishlar test zaxirasida boshidan oxirigacha ishlaydi, real chipta yoki vaucher berilmaydi va hech narsa hisobdan yechilmaydi. Production koʻrib chiqilgandan soʻng beriladigan dt_live_ kaliti jonli zaxiraga murojaat qiladi va depozitingiz hisobidan hisob-kitob qilinadi.

Sandbox va production bronlari dasturchi portalingizda alohida saqlanadi (har bir bron belgilanadi), doiralar, limitlar va IP qoidalari esa har bir muhit uchun alohida boshqariladi.

Soʻrov limitlari va kvotalar

Har bir kalit token paqiri (soniyasiga barqaror soʻrovlar va keskin oʻsish) va kunlik kvota bilan cheklanadi. Sandbox standartlari: soniyasiga 2 ta soʻrov, keskin oʻsish 5, kuniga 2 000 ta soʻrov. Production limitlari har bir hisob uchun kelishiladi. Paqir limitidan oshish Retry-After sarlavhasi bilan 429 api_rate_limited javobini qaytaradi; kvota tugasa, UTC boʻyicha yarim tungacha 429 api_quota_exceeded qaytariladi.

Ogʻir qidiruvlar tabiatan asinxron: darhol searchId olish va qidiruv endpointʼini soʻrab turish uchun wait=false yuboring yoki toʻliq natijani bitta chaqiruvda olish uchun wait=true yuboring. Soʻrab turish ham boshqa soʻrovlar kabi limitlaringizga hisoblanadi.

Qidiruv/bron nisbati cheklovi

Qidiruvlar siz qilgan bronlarga nisbatan ham chegaralanadi. Siljuvchi davrning (standart boʻyicha 7 kun) har bir kuni bepul qidiruvlar miqdorini beradi va shu davrda qilingan har bir bron ustiga yana cap ta qidiruv qoʻshadi — cap hisobingiz uchun kelishilgan va dasturchi portalida koʻrsatilgan bir bronga qidiruvlar soni. Soʻrab turishlar, narxlash, tarif qoidalari va kontentni oʻqish hech qachon hisoblanmaydi; faqat parvoz va mehmonxona qidiruvi chaqiruvlari hisoblanadi.

Miqdor tugagach, qidiruvlar keyingi UTC yarim tuniga — davrning eng eski kuni chiqib ketadigan vaqtga ishora qiluvchi Retry-After sarlavhasi bilan 429 look_to_book_exceeded javobini qaytaradi. Bron miqdorni darhol qayta ochadi. Dasturchi portalidagi Qidiruv/bron nisbati kartasi jonli hisoblagichlar, chegara va qolgan miqdorni koʻrsatadi; agar integratsiyangiz qonuniy ravishda bron qilganidan ancha koʻp qidirsa, rad javobini qayta urinishlar bilan aylanib oʻtish oʻrniga bizdan chegarani oshirishni soʻrang.

Idempotentlik

Pul yoki zaxirani band qiladigan endpointʼlar — buyurtma yoki bron yaratish, chipta rasmiylashtirish, bekor qilish — Idempotency-Key sarlavhasini talab qiladi (128 belgigacha boʻlgan istalgan noyob satr, UUID ideal). Xuddi shu kalit bilan qayta urinish takroriy yozuv yaratish oʻrniga asl javobni qaytaradi; qayta ishlatilgan kalit ostida boshqa tana yuborilsa, 409 qaytariladi.

Versiyalash

Versiya yoʻlda koʻrsatiladi (/v1). Qoʻshimcha oʻzgarishlar — yangi ixtiyoriy maydonlar, yangi enum qiymatlari, yangi endpointʼlar — versiyani oshirmasdan chiqariladi, shuning uchun javoblarni ehtiyotkorlik bilan tahlil qiling va notanish maydonlarni eʼtiborsiz qoldiring. Moslikni buzadigan oʻzgarishlar migratsiya davri bilan yangi asosiy versiyada chiqariladi; Oʻzgarishlar jurnali qoʻllanmasi har bir oʻzgarishni sanab oʻtadi.