API harga penerbangan: angka yang tampil belum menjadi tarif

Demonya berjalan. Seorang pengembang menyambungkan API harga penerbangan ke kalender hari-hari termurah untuk terbang, kisi terisi angka, dan semua orang di ruangan senang. Lalu pelanggan nyata pertama memilih tanggal, melihat angka lebih rendah di halaman hasil daripada di halaman pembayaran, dan menulis ke dukungan dengan tangkapan layar. Tidak ada yang rusak. API melakukan persis yang diminta: menjawab pertanyaan tentang harga, dan situs menganggap jawaban itu sebagai janji.
Harga adalah penawaran dengan ingatan pendek
Tarif maskapai bukan label tetap yang menempel pada kursi. Ia adalah kelas yang terbuka dan tertutup seiring kursi terjual, dan angkanya berubah menurut susunan penumpang, penerbangan yang tepat, pajak bandara terkait, dan mata uang penawaran. Respons harga adalah potret pada satu saat untuk satu set masukan. Perlakukan sebagai fakta masa lalu, dan Anda membangun hal yang benar; perlakukan sebagai fakta masa kini, dan Anda menghabiskan sebulan untuk pengembalian dana.
Karena itu pertanyaan yang berguna bagi pengembang bukan sekadar berapa harganya. Melainkan harga jenis apa ini, seberapa tua, dan apa yang akan dilakukan sistem jika ternyata salah.
Tiga angka yang semuanya disebut harga
Kebanyakan penyedia mengembalikan ketiganya di suatu tempat dalam dokumentasi, sering dengan nama bidang yang sama. Pisahkan ketiganya di model data Anda sejak hari pertama.
| Keadaan | Asalnya | Kesegaran | Bisa dijual? | Yang ditampilkan |
|---|---|---|---|---|
| Harga jelajah | Pencarian berbasis cache atau agregasi, dibuat demi kecepatan dan cakupan | Mungkin sudah usang dan tidak dihitung untuk penumpang Anda | Tidak | Kata «mulai dari» dan catatan bahwa bisa berubah |
| Penawaran berharga | Permintaan langsung untuk rute, jenis penumpang, dan tarif yang tepat | Segar saat dipanggil, dengan masa berlaku atau sinyal hitung ulang | Ya, sampai kedaluwarsa | Total, pajak dirinci, aturan tarif |
| Jumlah yang diterbitkan | Yang benar-benar ditagih maskapai atau sistem penerbitan saat pesanan | Final | Sudah terjual | Kuitansi, dicocokkan dengan penawaran |
Harga jelajah memungkinkan kalender dan lencana «mulai dari», dan membangunnya itu bagus. Tetapi ia bukan objek yang sama dengan baris kedua. Kesalahannya adalah satu bidang price yang menampung ketiganya.
Dalam praktik, itu berarti tiga tipe atau tiga tabel dalam kode, bukan satu dengan sebuah penanda. Harga jelajah boleh salah sedikit karena hanya ajakan untuk mengeklik. Penawaran berharga adalah komitmen yang akan Anda ambil atas nama sendiri, jadi disimpan bersama waktu pengambilan, masukan yang menghasilkannya, dan pengenal yang akan diminta penyedia saat pesanan. Jumlah yang diterbitkan adalah akuntansi. Ketika dukungan bertanya mengapa pelanggan membayar angka berbeda dari yang ada di email, jawabannya ada di celah antarbaris, dan Anda hanya bisa membacanya jika menyimpan ketiganya.
Apa yang harus dibawa respons harga
Angka polos tidak cukup untuk membangun halaman pembayaran. Saat membaca contoh respons penyedia, carilah hal berikut dan curigai apa pun yang datang sebagai teks bebas.
- Mata uang, tertulis di respons, bukan diasumsikan dari akun Anda.
- Tarif dasar dan pajak terpisah, agar Anda bisa menampilkan rincian dan agar perubahan pajak tidak tampak seperti perubahan tarif.
- Jenis penumpang yang menjadi dasar perhitungan harga. Harga dewasa dikali tiga bukan tarif keluarga.
- Aturan tarif dan bagasi sebagai data terstruktur, karena merekalah yang menentukan apakah opsi murah benar-benar lebih murah bagi pelanggan Anda.
- Masa berlaku atau sinyal hitung ulang: stempel waktu, atau pernyataan eksplisit bahwa Anda harus menghitung ulang sebelum memesan.
Butir terakhir inilah yang sering dilewati. Jika tidak ada apa pun di respons yang menyebut berapa lama penawaran hidup, Anda menebak, dan tebakan itu terjadi di produksi.
Hitung ulang sebelum pesanan, bukan sesudahnya
Ritme paling aman memuat sebuah aturan. Cari untuk menjelajah. Saat pelanggan memilih rute, minta penawaran berharga langsung untuk rute dan penumpang itu. Tunjukkan total tersebut kepada pelanggan. Baru setelah itu buat pesanan. Jika harga langsung berbeda dari yang ada di halaman hasil, Anda memberi tahu pelanggan sebelum mereka membayar, dengan kata-kata jelas, bukan sesudahnya.
Lewati langkah tengah itu dan Anda mewarisi selisihnya. Entah Anda menagih lebih dari yang dilihat pelanggan dan kehilangan penjualan di halaman pembayaran, atau Anda menepati angka yang lebih rendah dan selisih keluar dari margin sendiri. Agen kecil bisa menyerap itu beberapa kali, tetapi tidak sebagai desain.
Tanyakan ini secara tertulis sebelum integrasi
Dokumentasi menggambarkan jalur bahagia. Perilaku yang membuat Anda rugi ada di jawaban atas daftar pendek pertanyaan, dan lebih baik jawabannya ada di email daripada di telepon.
- Apakah harga di respons pencarian langsung atau dari cache, dan apakah itu tertulis di respons itu sendiri?
- Apakah ada panggilan penetapan harga terpisah untuk rute yang tepat, dan apakah wajib sebelum pesanan?
- Apa yang terjadi saat pesanan jika harga bergeser: penolakan, harga baru di respons, atau penerbitan diam-diam dengan jumlah baru?
- Bagaimana pajak dan biaya tambahan maskapai dirinci, dan bisakah berubah antara penetapan harga dan penerbitan?
- Dalam mata uang apa harga dihitung, dan di mana konversi dilakukan jika pelanggan melihat mata uang lain?
- Berapa lama penawaran berharga tetap berlaku, dan bagaimana Anda mengetahuinya?
Penyedia yang menjawab dengan tepat sudah memikirkan halaman pembayaran. Yang menjawab «selalu terbaru» belum memberi apa pun yang bisa Anda uji. Jika Anda tidak bisa mencoba perilakunya sendiri, itu alasan untuk memandang seluruh susunan dengan cara lain sebelum membangun di atasnya.
Berapa harga sebuah kesalahan
Jarang gagal dengan keras. Ia muncul sebagai penurunan kecil di langkah pembayaran yang tak seorang pun kaitkan dengan harga, sebagai tiket dukungan yang diawali «harganya berubah», sebagai pelanggan yang percaya halaman hasil dan kini tidak lagi. Staf akhirnya mengonfirmasi ulang tarif secara manual sebelum penerbitan. Seseorang akhirnya mengusulkan aturan pembulatan harga ke atas demi aman, dan situs menjadi mahal di satu layar tempat orang membandingkan. Tiap biaya itu adalah pajak atas keputusan yang murah jika dibuat benar sejak awal.
Di mana posisi platform ini
Platform ini menyediakan API penerbangan dan hotel, diaktifkan per penyewa. Akses dimulai dari percakapan, bukan kunci swalayan; tidak ada formulir pendaftaran yang menyerahkan token dan tabel batas kepada Anda. Kami tidak menerbitkan angka latensi, cakupan, atau jumlah tarif di sini, karena angka yang tidak bisa kami tunjukkan cara mengujinya tidak layak dicetak. Yang bisa Anda lakukan adalah membawa pertanyaan di atas ke percakapan itu dan meminta melihat respons untuk penawaran berharga, bukan hanya untuk pencarian. Jika Anda sudah di tahap itu, halaman API perjalanan adalah awalnya.