Mühitlər, limitlər və versiyalaşdırma

Sandbox və production, bir baza URL

Baza URL: https://api.dubaitrip.com/v1. Sandbox və production onu paylaşır; imzaladığınız açar mühiti seçir. dt_sbx_ açarı təchizatçılarımızın test mühitlərində işləyir — axtarışlar, qiymətləndirmə, tarif yoxlamaları, sifarişlər, rezervasiyalar, biletlərin rəsmiləşdirilməsi və ləğvlər test inventarında əvvəldən sona qədər işləyir, real bilet və ya vauçer olmadan və heç nə ödənilmədən. Production yoxlamasından sonra verilən dt_live_ açarı canlı inventara çatır və depozitinizdən hesablaşdırılır.

Sandbox və production rezervasiyaları tərtibatçı portalınızda ayrı saxlanılır (hər rezervasiya işarələnir), skoplar, limitlər və IP qaydaları isə hər mühit üçün ayrıca idarə olunur.

Sorğu limitləri və kvotalar

Hər açar token bucket (saniyədə davamlı sorğu sayı üstəgəl pik həcm) və gündəlik kvota ilə məhdudlaşdırılır. Sandbox defolt dəyərləri: saniyədə 2 sorğu, pik həcm 5, gündə 2000 sorğu. Production limitləri hər hesab üçün razılaşdırılır. Bucket aşıldıqda Retry-After başlığı ilə 429 api_rate_limited cavabı qaytarılır; kvota tükəndikdə UTC gecə yarısına qədər 429 api_quota_exceeded cavabı qaytarılır.

Ağır axtarışlar dizayn etibarilə asinxrondur: dərhal searchId almaq və axtarış endpoint-ini sorğulamaq üçün wait=false, tam nəticəni bir çağırışda almaq üçün isə wait=true ötürün. Sorğulama (polling) istənilən digər sorğu kimi limitlərinizdən sayılır.

Baxış/rezervasiya limiti

Axtarışlar həmçinin etdiyiniz rezervasiyalara nisbətdə məhdudlaşdırılır. Sürüşən dövrün (defolt olaraq 7 gün) hər günü pulsuz axtarış limiti verir və həmin dövrdə edilən hər rezervasiya üstəlik cap qədər axtarış əlavə edir — cap hesabınız üçün razılaşdırılmış və tərtibatçı portalında göstərilən rezervasiya başına axtarış sayıdır. Sorğulamalar, qiymətləndirmə, tarif qaydaları və məzmun oxunuşları heç vaxt sayılmır; yalnız uçuş və otel axtarışı çağırışları sayılır.

Limit tükəndikdə axtarışlar növbəti UTC gecə yarısını — dövrün ən köhnə gününün çıxdığı anı — göstərən Retry-After başlığı ilə 429 look_to_book_exceeded cavabı qaytarır. Rezervasiya limiti dərhal yenidən açır. Tərtibatçı portalındakı Baxış/rezervasiya kartı canlı sayğacları, cap dəyərini və qalan miqdarı göstərir; inteqrasiyanız qanuni olaraq rezervasiyadan xeyli çox axtarış edirsə, rəddə baxmayaraq təkrar cəhd etmək əvəzinə bizdən cap dəyərini artırmağı xahiş edin.

İdempotentlik

Pul və ya inventar öhdəliyi yaradan endpoint-lər — sifariş və ya rezervasiya yaratmaq, bilet rəsmiləşdirmək, ləğv etmək — Idempotency-Key başlığı tələb edir (128 simvola qədər istənilən unikal sətir, UUID idealdır). Eyni açarla təkrar cəhd dublikat yaratmaq əvəzinə ilkin cavabı qaytarır; təkrar istifadə olunan açarla fərqli gövdə 409 cavabı alır.

Versiyalaşdırma

Versiya yolda göstərilir (/v1). Əlavə xarakterli dəyişikliklər — yeni istəyə bağlı sahələr, yeni enum dəyərləri, yeni endpoint-lər — versiya artırılmadan buraxılır, buna görə ehtiyatla parse edin və naməlum sahələri nəzərə almayın. Uyğunluğu pozan dəyişikliklər miqrasiya müddəti ilə yeni əsas versiya alır; Dəyişikliklər jurnalı bələdçisi hər dəyişikliyi sadalayır.