Geliştirici genel bakışı
İki API, tek sözleşme. TravelDistro, Rate Extra'nın B2B seyahat API'sidir; Hotel API Safaryar Holidays tarafından sağlanır. Bu sayfa herkese açık referanslara derin bağlantılar veren kavramsal bir haritadır; onları kopyalamaz.
TravelDistro API
- Auth
- TD-HMAC-SHA256 (Authorization, X-TD-Timestamp, X-TD-Nonce)
- Base URL
- https://api.traveldistro.com/v1
- Support
- api@traveldistro.com
Safaryar Holidays Hotel API
İstanbul'daki Safaryar Holidays (Sindibad Turizm Ticaret A.Ş.) ile ayrıca sözleşmelenir.
- Auth
- X-API-Key başlığı
- Base URL
- https://api.safaryarholidays.com
- Support
- support@safaryarholidays.com
API anahtarı ve sözleşme kapsamı
Tek anahtar sözleşmenizdeki her dikeyi kapsar. Sözleşme dışı bir ürün tüm uç noktalarında 403 MODULE_NOT_ENABLED döner; GET /v1/account açık olanları listeler.
Ön ödemeli cüzdan
Rezervasyonlar sözleşmeli para birimindeki ön ödemeli bakiyeden düşer. Bakiye, ekstre ve kurlar API ile okunabilir. 429 ya da başarısız rezervasyon hiçbir ücret oluşturmaz.
quote_token akışı
Her arama, quote_expires_at'e kadar fiyatı kilitleyen bir quote_token ile fiyatlanmış sonuçlar döner. Rezervasyon token'ı kullanır; fiyatlar sizin tarafınızda asla önbelleklenmez.
Idempotency
Rezervasyon ve iptal Idempotency-Key ister. Aynı anahtar ve gövde orijinal yanıtı tekrar döner; yeniden denenen bir istek çift rezervasyon yapamaz.
Hız sınırları
Acente bazlı; okuma ve yazma bir dakikalık kayan pencerede ayrı sayılır, X-RateLimit-* başlıklarıyla ve 429'da Retry-After ile raporlanır.
Hata zarfı
Her hata sabit bir error.code ve details nesnesi içeren tek bir zarf kullanır; istemciler mesaja değil koda göre dallanır.
Webhook'lar
Giden olaylar imzalıdır, üstel geri çekilmeyle iki kez yeniden denenir ve X-TD-Webhook-Id ile tekilleştirilir. Hotel API X-Webhook-Signature ile imzalar ve yeniden denemez.
Lisanslı seyahat acentesi misiniz? API erişimi için başvurun.
API erişimi al