Langkau ke kandungan
Blog

API harga penerbangan: kenapa angka yang dipaparkan belum lagi tambang

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Demo berfungsi. Seorang pembangun menyambung API harga penerbangan ke kalendar hari paling murah untuk terbang, grid dipenuhi angka dan semua orang dalam bilik berpuas hati. Kemudian pelanggan sebenar pertama memilih tarikh, melihat angka lebih rendah pada halaman hasil berbanding halaman pembayaran, lalu menghantar tangkapan skrin kepada sokongan. Tiada yang rosak. API itu melakukan tepat apa yang diminta: ia menjawab soalan tentang harga, dan laman web menganggap jawapan itu sebagai janji.

Harga ialah tawaran yang ingatannya pendek

Tambang penerbangan bukan label tetap pada tempat duduk. Ia ialah baldi yang dibuka dan ditutup apabila tempat duduk terjual, dan angka yang melekat padanya berubah mengikut gabungan penumpang, penerbangan tepat, cukai lapangan terbang yang terlibat dan mata wang yang digunakan untuk sebut harga. Respons harga ialah gambar sekilas tentang itu, diambil pada satu ketika untuk satu set input. Anggap ia fakta tentang masa lalu dan anda akan membina perkara yang betul; anggap ia fakta tentang masa kini dan anda akan menghabiskan sebulan menguruskan bayaran balik.

Maka soalan berguna bagi pembangun bukan sekadar berapa harganya. Ia ialah jenis harga apakah ini, sudah berapa lama, dan apa yang akan dilakukan sistem jika ternyata salah.

Tiga angka yang semuanya digelar harga

Kebanyakan penyedia memulangkan ketiga-tiganya di suatu tempat dalam dokumentasi, selalunya di bawah nama medan yang sama. Pisahkan ia dalam model data anda sendiri sejak hari pertama.

KeadaanDari mana datangnyaSetakat mana segarBoleh dijual?Apa yang dipaparkan
Harga semak imbasCarian cache atau agregat, dibina untuk kelajuan dan keluasanMungkin lapuk, dan tidak dikira untuk penumpang andaTidakPerkataan „dari” dan label bahawa ia boleh berubah
Tawaran berhargaPermintaan langsung untuk laluan, jenis penumpang dan tambang yang tepatSegar ketika panggilan, dengan tarikh luput atau isyarat harga semulaYa, sehingga tamat tempohJumlah, cukai diperincikan, peraturan tambang
Jumlah tiket dikeluarkanApa yang sebenarnya dicaj oleh syarikat penerbangan atau sistem pengeluar semasa pesananMuktamadSudah dijualResit; padankan dengan tawaran

Harga semak imbas ialah yang membolehkan kalendar dan lencana „termurah dari”, dan ia memang perkara baik untuk dibina. Cuma ia bukan objek yang sama dengan baris kedua. Kesilapannya ialah satu medan price yang menerima ketiga-tiganya.

Dalam amalan ini bermakna tiga jenis atau jadual berasingan dalam kod anda, bukan satu dengan bendera. Harga semak imbas dibenarkan silap dalam perkara kecil kerana ia sekadar dorongan untuk klik. Tawaran berharga ialah komitmen yang anda akan buat atas nama sendiri, jadi ia disimpan bersama masa ia diambil, input yang menghasilkannya dan pengecam yang akan diminta kembali oleh penyedia semasa pesanan. Jumlah tiket dikeluarkan ialah perakaunan. Apabila sokongan bertanya mengapa pelanggan membayar angka berbeza daripada yang ada dalam e-mel, jawapannya terletak pada jurang antara baris, dan anda hanya boleh membaca jurang itu jika anda menyimpan ketiga-tiganya.

Apa yang mesti dibawa oleh respons harga

Angka kosong tidak cukup untuk membina pembayaran. Apabila membaca contoh respons penyedia, cari perkara berikut, dan curigai apa-apa yang tiba sebagai teks bebas.

  • Mata wang, dinyatakan pada respons, bukan diandaikan daripada akaun anda.
  • Tambang asas dan cukai secara berasingan, supaya anda boleh menunjukkan pecahan dan perubahan cukai tidak kelihatan seperti perubahan tambang.
  • Jenis penumpang yang menjadi asas pengiraan harga. Harga dewasa didarab tiga bukan tambang keluarga.
  • Peraturan tambang dan bagasi sebagai data berstruktur, kerana ia menentukan sama ada pilihan murah benar-benar lebih murah untuk pelanggan anda.
  • Isyarat tamat tempoh atau harga semula: cap masa, atau kenyataan jelas bahawa anda mesti menentukan harga semula sebelum membuat pesanan.

Item terakhir itulah yang sering dilangkau. Jika tiada apa dalam respons memberitahu berapa lama tawaran itu hidup, anda sedang meneka, dan tekaan itu dibuat dalam pengeluaran.

Tentukan harga semula sebelum pesanan, bukan selepasnya

Rentak paling selamat mempunyai peraturan di dalamnya. Cari untuk menyemak imbas. Apabila pelanggan memilih laluan, minta tawaran berharga langsung untuk laluan dan penumpang itu sahaja. Tunjukkan jumlah itu kepada pelanggan. Barulah cipta pesanan. Jika harga langsung berbeza daripada yang ada pada halaman hasil, anda memberitahu pelanggan sebelum mereka membayar, dengan kata-kata mudah, bukan selepas mereka membayar.

Langkau langkah tengah dan anda mewarisi perbezaannya. Sama ada anda mengecaj lebih daripada yang pelanggan lihat lalu kehilangan jualan di halaman pembayaran, atau anda menghormati angka lebih rendah dan jurang itu keluar daripada margin anda sendiri. Agensi kecil boleh menyerapnya beberapa kali; ia tidak boleh menyerapnya sebagai reka bentuk.

Tanya perkara ini secara bertulis sebelum integrasi

Dokumentasi menerangkan laluan yang lancar. Tingkah laku yang merugikan anda terdapat dalam jawapan kepada senarai pendek soalan, dan jawapan itu lebih baik dimiliki dalam e-mel berbanding dalam panggilan.

  1. Adakah harga dalam respons carian langsung atau daripada cache, dan adakah itu dinyatakan pada respons itu sendiri?
  2. Adakah terdapat panggilan penentuan harga berasingan untuk laluan tepat, dan adakah ia wajib sebelum pesanan?
  3. Apa berlaku semasa pesanan jika harga sudah beralih: penolakan, harga baharu dalam respons, atau tiket senyap pada jumlah baharu?
  4. Bagaimana cukai dan surcaj pengangkut diperincikan, dan bolehkah ia berubah antara penentuan harga dan pengeluaran tiket?
  5. Dalam mata wang apakah harga dikira, dan di mana penukaran berlaku jika pelanggan melihat yang lain?
  6. Berapa lama tawaran berharga kekal sah, dan bagaimana anda akan tahu?

Penyedia yang menjawab dengan tepat telah memikirkan tentang pembayaran. Yang menjawab „ia sentiasa terkini” tidak memberitahu anda apa-apa yang boleh diuji. Jika anda tidak dapat mencuba tingkah laku itu sendiri, itu sebab untuk melihat keseluruhan tindanan secara berbeza sebelum anda komited membina di sekelilingnya.

Apa kos jika silap

Jarang ia gagal dengan kuat. Ia gagal sebagai kejatuhan kecil pada langkah pembayaran yang tiada siapa kaitkan dengan harga, sebagai tiket sokongan yang bermula dengan „harga berubah”, sebagai pelanggan yang mempercayai halaman hasil dan kini tidak lagi. Kakitangan akhirnya mengesahkan semula tambang secara manual sebelum tiket dikeluarkan. Akhirnya seseorang mencadangkan peraturan yang membundarkan harga ke atas untuk selamat, dan laman itu menjadi mahal pada satu skrin tempat orang membandingkan. Setiap satunya ialah cukai ke atas keputusan yang murah untuk dibuat dengan betul pada permulaan.

Di mana platform ini berada

Platform ini menawarkan API penerbangan dan hotel, diaktifkan bagi setiap penyewa. Akses bermula sebagai perbincangan, bukan kunci layan diri, jadi tiada borang pendaftaran yang menyerahkan token dan jadual had kadar. Halaman ini tidak menerbitkan latensi, liputan atau bilangan tambang, kerana angka yang kami tidak dapat tunjukkan cara mengujinya tidak wajar dicetak. Apa yang boleh anda lakukan ialah membawa soalan di atas ke perbincangan itu dan meminta untuk melihat respons bagi tawaran berharga, bukan sekadar carian. Jika itu peringkat anda, halaman API perjalanan ialah tempat ia bermula.

Sidang Pengarang Tekravel

Meja teknologi pelancongan

Meja teknologi pelancongan Tekravel menulis untuk industri: pemilik agensi, konsolidator dan pembangun yang mengintegrasikan mereka. Setiap artikel disemak pada platform yang diterangkannya sebelum diterbitkan.