Lingkungan, batas, dan pembuatan versi

Sandbox dan produksi, satu URL dasar

URL dasar: https://api.dubaitrip.com/v1. Sandbox dan produksi menggunakannya bersama; kunci yang Anda gunakan untuk menandatangani menentukan lingkungannya. Kunci dt_sbx_ berjalan terhadap lingkungan uji pemasok kami — pencarian, penetapan harga, cek tarif, pesanan, pemesanan, penerbitan tiket, dan pembatalan semuanya berfungsi dari awal hingga akhir pada inventaris uji, tanpa tiket atau voucher sungguhan dan tanpa biaya apa pun. Kunci dt_live_, yang diterbitkan setelah peninjauan produksi, menjangkau inventaris live dan diselesaikan dari deposit Anda.

Pemesanan sandbox dan produksi dipisahkan di portal pengembang Anda (setiap pemesanan diberi tanda), dan cakupan, batas, serta aturan IP dikelola per lingkungan.

Batas laju dan kuota

Setiap kunci dibatasi oleh token bucket (permintaan berkelanjutan per detik ditambah burst) dan kuota harian. Bawaan sandbox: 2 permintaan/detik, burst 5, 2.000 permintaan/hari. Batas produksi disepakati per akun. Melebihi bucket dijawab dengan 429 api_rate_limited beserta header Retry-After; kuota yang habis dijawab dengan 429 api_quota_exceeded hingga tengah malam UTC.

Pencarian berat sengaja dibuat asinkron: kirim wait=false untuk langsung mendapatkan searchId lalu polling endpoint pencarian, atau wait=true untuk menerima hasil lengkap dalam satu panggilan. Polling dihitung terhadap batas Anda seperti permintaan lainnya.

Pembatas look-to-book

Pencarian juga dijatah berdasarkan pemesanan yang Anda buat. Setiap hari dalam jendela bergulir (7 hari secara bawaan) memberikan jatah pencarian gratis, dan setiap pemesanan yang dibuat dalam jendela itu menambahkan sejumlah cap pencarian lagi — cap adalah angka pencarian per pemesanan yang disepakati untuk akun Anda dan ditampilkan di portal pengembang. Polling, penetapan harga, aturan tarif, dan pembacaan konten tidak pernah dihitung; hanya panggilan pencarian penerbangan dan hotel.

Begitu jatah habis, pencarian dijawab 429 look_to_book_exceeded dengan header Retry-After yang menunjuk ke tengah malam UTC berikutnya, saat hari tertua dalam jendela keluar. Sebuah pemesanan langsung membuka kembali jatah. Kartu Look-to-book di portal pengembang menampilkan penghitung live, cap, dan sisa jatah; jika integrasi Anda memang wajar melakukan pencarian jauh lebih banyak daripada pemesanan, minta kami menaikkan cap alih-alih terus mencoba ulang meski ditolak.

Idempotensi

Endpoint yang mengikat uang atau inventaris — membuat pesanan atau pemesanan, menerbitkan, membatalkan — memerlukan header Idempotency-Key (string unik apa pun hingga 128 karakter, UUID ideal). Mengulang dengan kunci yang sama mengembalikan respons asli alih-alih membuat duplikat; body berbeda dengan kunci yang dipakai ulang dijawab 409.

Pembuatan versi

Versi ada di path (/v1). Perubahan tambahan — kolom opsional baru, nilai enum baru, endpoint baru — dirilis tanpa kenaikan versi, jadi lakukan parsing secara defensif dan abaikan kolom yang tidak dikenal. Perubahan yang merusak kompatibilitas mendapat versi mayor baru dengan jendela migrasi; panduan Catatan perubahan mencantumkan setiap perubahan.