Langkau ke kandungan
Demo langsung

Mula pantas

Dari pendaftaran hingga penerbangan yang ditempah dalam sandbox, dalam lima langkah.

  1. 1. Dapatkan kelayakan sandbox
  2. 2. Tandatangani setiap permintaan
  3. 3. Buat panggilan pertama anda
  4. 4. Lengkapkan aliran tempahan
  5. 5. Mohon production

1. Dapatkan kelayakan sandbox

Daftar di halaman API pelancongan. Sebaik sahaja e-mel anda disahkan, akaun rakan kongsi anda wujud dan ID kunci sandbox dipaparkan pada skrin; rahsia dihantar melalui pautan pendedahan sekali guna ke alamat yang sama. Simpan dalam pengurus rahsia anda — ia dipaparkan tepat sekali sahaja.

Anda juga menerima kata laluan sementara untuk portal pembangun, tempat anda boleh mencipta dan memutar kunci, menetapkan senarai benar IP, memantau penggunaan dan memohon production.

2. Tandatangani setiap permintaan

Setiap panggilan membawa empat header: X-API-Key (ID kunci anda), X-Timestamp (saat unix), X-Nonce (16–128 aksara rawak) dan X-Signature — HMAC-SHA256 dalam hex huruf kecil bagi rentetan kanonik, dikunci dengan rahsia anda.

Rentetan kanonik terdiri daripada lima baris yang disambung dengan aksara baris baharu: kaedah HTTP dalam huruf besar, laluan berserta rentetan query tepat seperti yang dihantar, cap masa, nonce, dan SHA-256 dalam hex huruf kecil bagi badan mentah (badan kosong dicincang sebagai SHA-256 bagi sifar bait). Cap masa mesti berada dalam lingkungan 300 saat daripada jam kami; nonce boleh digunakan sekali dalam tempoh 10 minit.

Rentetan kanonik
POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. Buat panggilan pertama anda

Cari penerbangan pada sandbox. Sandbox disambungkan ke persekitaran ujian pembekal kami, jadi carian memulangkan inventori dan harga ujian, dan tempahan yang dibuat di sana ialah tempahan ujian — tiada tiket sebenar, tiada caj. Setiap halaman rujukan mempunyai contoh lengkap dalam cURL, Node.js, Python dan PHP — salin, isikan ID kunci dan rahsia anda, kemudian jalankan.

cURL
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. Lengkapkan aliran tempahan

Penerbangan: carian → tetapkan harga tawaran yang dipilih → cipta pesanan dengan penumpang dan maklumat hubungan → keluarkan tiket → (pilihan) dapatkan sebut harga dan mohon bayaran balik. Hotel: carian → baca bilik sesebuah hartanah → semak kadar → cipta tempahan → (pilihan) dapatkan sebut harga dan batalkan.

ID tawaran dan kunci kadar adalah legap dan bertempoh singkat. Sentiasa tetapkan harga atau semak sejurus sebelum anda mengesahkan: jika harga berubah, anda menerima 409 price_changed dengan jumlah baharu, dan anda yang membuat keputusan.

5. Mohon production

Apabila integrasi anda melengkapkan aliran dari awal hingga akhir dalam sandbox, buka portal pembangun dan mohon production. Kami menyemak aktiviti sandbox (carian, satu pesanan, satu tempahan, satu pembatalan) dan butiran integrasi anda, kemudian menukar akaun anda: pasangan kunci production dihantar melalui e-mel menerusi pautan pendedahan sekali guna yang sama. URL asas yang sama — permintaan yang ditandatangani dengan kunci dt_live_ sampai ke pembekal sebenar dan diselesaikan daripada deposit anda; kunci sandbox anda terus berfungsi untuk ujian.