Persekitaran, had dan versi

Sandbox dan production, satu URL asas

URL asas: https://api.dubaitrip.com/v1. Sandbox dan production berkongsi URL ini; kunci yang anda gunakan untuk menandatangani menentukan persekitaran. Kunci dt_sbx_ berjalan terhadap persekitaran ujian pembekal kami — carian, penetapan harga, semakan kadar, pesanan, tempahan, pengeluaran tiket dan pembatalan semuanya berfungsi dari awal hingga akhir pada inventori ujian, tanpa tiket atau baucar sebenar dan tanpa sebarang caj. Kunci dt_live_, yang dikeluarkan selepas semakan production, sampai ke inventori sebenar dan diselesaikan daripada deposit anda.

Tempahan sandbox dan production diasingkan dalam portal pembangun anda (setiap tempahan ditanda), dan skop, had serta peraturan IP diurus bagi setiap persekitaran.

Had kadar dan kuota

Setiap kunci dikawal oleh token bucket (permintaan berterusan sesaat serta letusan) dan kuota harian. Lalai sandbox: 2 permintaan/saat, letusan 5, 2,000 permintaan/hari. Had production dipersetujui bagi setiap akaun. Melebihi bucket menghasilkan 429 api_rate_limited dengan header Retry-After; menghabiskan kuota menghasilkan 429 api_quota_exceeded sehingga tengah malam UTC.

Carian berat bersifat tak segerak mengikut reka bentuk: hantar wait=false untuk mendapatkan searchId serta-merta dan tinjau endpoint carian, atau wait=true untuk menerima hasil lengkap dalam satu panggilan. Tinjauan dikira dalam had anda seperti permintaan lain.

Kawalan look-to-book

Carian juga dicatu berbanding tempahan yang anda buat. Setiap hari dalam tetingkap bergerak (7 hari secara lalai) memberikan peruntukan carian percuma, dan setiap tempahan yang dibuat dalam tetingkap itu menambah cap carian lagi — cap ialah angka carian bagi setiap tempahan yang dipersetujui untuk akaun anda dan dipaparkan dalam portal pembangun. Tinjauan, penetapan harga, peraturan tambang dan bacaan kandungan tidak pernah dikira; hanya panggilan carian penerbangan dan hotel dikira.

Sebaik sahaja peruntukan habis, carian menghasilkan 429 look_to_book_exceeded dengan header Retry-After yang menunjuk ke tengah malam UTC berikutnya, apabila hari tertua dalam tetingkap tercicir. Satu tempahan membuka semula peruntukan serta-merta. Kad Look-to-book dalam portal pembangun memaparkan pembilang langsung, had dan baki yang tinggal; jika integrasi anda secara sah membuat carian jauh lebih banyak daripada tempahan, minta kami menaikkan had dan bukannya terus mencuba semula menerusi penolakan.

Idempotensi

Endpoint yang melibatkan wang atau inventori — mencipta pesanan atau tempahan, mengeluarkan tiket, membatalkan — memerlukan header Idempotency-Key (sebarang rentetan unik sehingga 128 aksara; UUID adalah ideal). Mencuba semula dengan kunci yang sama mengembalikan respons asal dan bukannya mencipta pendua; badan berbeza di bawah kunci yang digunakan semula menghasilkan 409.

Versi

Versi terdapat dalam laluan (/v1). Perubahan tambahan — medan pilihan baharu, nilai enum baharu, endpoint baharu — dilancarkan tanpa menaikkan versi, jadi huraikan secara defensif dan abaikan medan yang tidak dikenali. Perubahan yang memecahkan keserasian mendapat versi major baharu dengan tempoh migrasi; panduan Log perubahan menyenaraikan setiap perubahan.