Ortamlar, limitler ve sürümleme

Test ortamı ve canlı ortam, tek temel URL

Temel URL: https://api.dubaitrip.com/v1. Test ortamı ve canlı ortam bu adresi paylaşır; imzaladığınız anahtar ortamı seçer. dt_sbx_ anahtarı, tedarikçilerimizin test ortamlarına karşı çalışır — aramalar, fiyatlandırma, fiyat kontrolleri, siparişler, rezervasyonlar, biletleme ve iptaller test envanterinde uçtan uca çalışır; gerçek bilet veya voucher düzenlenmez ve hiçbir ücret alınmaz. Canlı ortam incelemesinden sonra verilen dt_live_ anahtarı ise canlı envantere ulaşır ve depozitonuzdan mahsup edilir.

Test ortamı ve canlı ortam rezervasyonları geliştirici portalınızda ayrı tutulur (her rezervasyon işaretlenir); kapsamlar, limitler ve IP kuralları ortam başına yönetilir.

Hız limitleri ve kotalar

Her anahtar bir token bucket (saniyedeki sürekli istek sayısı artı ani artış payı) ve günlük bir kota ile sınırlandırılır. Test ortamı varsayılanları: 2 istek/saniye, ani artış 5, 2.000 istek/gün. Canlı ortam limitleri hesap bazında kararlaştırılır. Bucket aşıldığında Retry-After başlığıyla 429 api_rate_limited yanıtı döner; kota tükendiğinde UTC gece yarısına kadar 429 api_quota_exceeded yanıtı döner.

Ağır aramalar tasarım gereği eşzamansızdır: hemen bir searchId almak ve arama uç noktasını yoklamak için wait=false, sonucun tamamını tek çağrıda almak için wait=true gönderin. Yoklama da diğer istekler gibi limitlerinizden düşer.

Arama/rezervasyon oranı koruması

Aramalar ayrıca yaptığınız rezervasyonlara göre de paylaştırılır. Geriye dönük pencerenin (varsayılan 7 gün) her günü ücretsiz bir arama hakkı verir ve o pencerede yapılan her rezervasyon bunun üzerine cap kadar arama daha ekler — cap, hesabınız için kararlaştırılan ve geliştirici portalında gösterilen rezervasyon başına arama sayısıdır. Yoklamalar, fiyatlandırma, ücret kuralları ve içerik okumaları asla sayılmaz; yalnızca uçuş ve otel arama çağrıları sayılır.

Hak tükendiğinde aramalar, pencerenin en eski gününün düştüğü bir sonraki UTC gece yarısını gösteren bir Retry-After başlığıyla 429 look_to_book_exceeded yanıtı verir. Bir rezervasyon hakkı hemen yeniden açar. Geliştirici portalındaki Arama/rezervasyon oranı kartı canlı sayaçları, sınırı ve kalan hakkı gösterir; entegrasyonunuz meşru olarak rezervasyondan çok daha fazla arama yapıyorsa, ret yanıtına rağmen yeniden denemek yerine sınırı yükseltmemizi isteyin.

İdempotans

Para veya envanter bağlayan uç noktalar — sipariş veya rezervasyon oluşturma, düzenleme, iptal — bir Idempotency-Key başlığı gerektirir (128 karaktere kadar benzersiz herhangi bir dize; UUID idealdir). Aynı anahtarla yeniden denemek, yinelenen bir kayıt oluşturmak yerine orijinal yanıtı döndürür; yeniden kullanılan bir anahtarla farklı bir gövde gönderilirse 409 yanıtı döner.

Sürümleme

Sürüm yoldadır (/v1). Ekleme niteliğindeki değişiklikler — yeni isteğe bağlı alanlar, yeni enum değerleri, yeni uç noktalar — sürüm artırılmadan yayınlanır; bu yüzden savunmacı biçimde ayrıştırın ve bilinmeyen alanları yok sayın. Geriye dönük uyumsuz değişiklikler, bir geçiş süresiyle birlikte yeni bir ana sürüm alır; Değişiklik günlüğü kılavuzu her değişikliği listeler.