Hızlı başlangıç

1. Test ortamı kimlik bilgilerini alın

Seyahat API'leri sayfasından kaydolun. E-postanız doğrulandığında iş ortağı hesabınız oluşur ve ekranda bir test ortamı anahtar kimliği gösterilir; gizli anahtar, aynı adrese gönderilen tek kullanımlık bir görüntüleme bağlantısıyla iletilir. Onu gizli anahtar yöneticinizde saklayın — yalnızca bir kez gösterilir.

Ayrıca geliştirici portalı için geçici bir parola alırsınız; portalda anahtar oluşturup yenileyebilir, bir IP izin listesi belirleyebilir, kullanımı izleyebilir ve canlı ortam talep edebilirsiniz.

2. Her isteği imzalayın

Her çağrı dört başlık taşır: X-API-Key (anahtar kimliğiniz), X-Timestamp (unix saniyesi), X-Nonce (16–128 rastgele karakter) ve X-Signature — kanonik bir dizenin gizli anahtarınızla hesaplanan, küçük harfli onaltılık HMAC-SHA256 değeri.

Kanonik dize, yeni satır karakteriyle birleştirilen beş satırdan oluşur: büyük harfle HTTP yöntemi, gönderildiği haliyle tam olarak yol ve sorgu dizesi, zaman damgası, nonce ve ham gövdenin küçük harfli onaltılık SHA-256 değeri (boş gövdenin özeti, sıfır baytın SHA-256 değeridir). Zaman damgaları saatimizden en fazla 300 saniye sapmalıdır; bir nonce 10 dakika içinde yalnızca bir kez kullanılabilir.

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. İlk çağrınızı yapın

Test ortamında (sandbox) bir uçuş arayın. Test ortamı tedarikçilerimizin test sistemlerine bağlıdır; bu nedenle aramalar test envanteri ve fiyatları döndürür, orada yapılan bir rezervasyon da test rezervasyonudur — gerçek bilet yok, ücret yok. Her referans sayfasında cURL, Node.js, Python ve PHP ile eksiksiz bir örnek bulunur — kopyalayın, anahtar kimliğinizi ve gizli anahtarınızı girin, çalıştırın.

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. Bir rezervasyon akışını tamamlayın

Uçuşlar: arama → seçilen teklifi fiyatlandırma → yolcular ve iletişim bilgileriyle sipariş oluşturma → bileti düzenleme → (isteğe bağlı) iade teklifi alıp iade talep etme. Oteller: arama → bir tesisin odalarını okuma → fiyatı kontrol etme → rezervasyonu oluşturma → (isteğe bağlı) teklif alıp iptal etme.

Teklif kimlikleri ve fiyat anahtarları opaktır ve kısa ömürlüdür. İşlemi onaylamadan hemen önce her zaman fiyatlandırın veya kontrol edin: fiyat değiştiyse yeni tutarla birlikte 409 price_changed alırsınız ve kararı siz verirsiniz.

5. Canlı ortam talep edin

Entegrasyonunuz akışı test ortamında uçtan uca tamamladığında geliştirici portalını açın ve canlı ortam talep edin. Test ortamı etkinliğini (aramalar, bir sipariş, bir rezervasyon, bir iptal) ve entegrasyon ayrıntılarınızı inceler, ardından hesabınızı geçiririz: canlı ortam anahtar çifti aynı tek kullanımlık görüntüleme bağlantısıyla e-postanıza gönderilir. Temel URL aynıdır — dt_live_ anahtarıyla imzalanan istekler canlı tedarikçilere ulaşır ve depozitonuzdan mahsup edilir; test ortamı anahtarınız test için çalışmaya devam eder.