Langkau ke kandungan
Blog

Integrasi API tempahan penerbangan: perkara yang dokumentasi tak sebut

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Tiket di papan tugas anda berbunyi "tambah penerbangan". Anda pernah memasang gerbang pembayaran, kalkulator kos penghantaran, mungkin peta, dan model yang anda bawa ialah yang paling jelas: cari, papar hasil, caj kad, siap. Kemudian tempahan sebenar pertama kembali dengan harga yang lain daripada halaman hasil, yang kedua timeout dan tiada siapa boleh memastikan sama ada pelanggan mendapat tempat duduk, dan seseorang dari bahagian operasi bertanya kenapa ada reservasi tetapi tiada tiket. Integrasi API tempahan penerbangan dari luar nampak seperti checkout e-dagang. Di bawahnya, ia transaksi teragih terhadap sistem yang direka lama sebelum REST, dan kebanyakan kejutan datang daripada jurang itu.

Tulisan ini untuk pembangun yang belum pernah melihat PNR. Ia bukan tentang endpoint pembekal tertentu; nama berubah antara penyedia, bentuknya tidak.

Urutan panggilan di sebalik integrasi API tempahan penerbangan

Hampir setiap API penerbangan, apa pun nama kaedahnya, melalui empat langkah yang sama. Menetapkan sempadan antara langkah-langkah itu dengan betul ialah sebahagian besar kerja.

LangkahApa yang anda dapatApa yang mesti disimpanApa yang boleh silap
CarianItinerari dengan harga dan kunci tawaran atau tambang yang legapTiada yang kekal — hasil cepat basiHarga dianggap muktamad; kunci tamat tempoh sebelum checkout
Semak harga / sahkanHarga disahkan, peraturan tambang, bagasi, kadang-kadang medan penumpang wajibTawaran yang disahkan dan tempoh lakunyaHarga berubah; kelas habis dijual; peraturan berbeza daripada yang dipaparkan
TempahReservasi — PNR — dengan kod tempahan dan tarikh akhir pengeluaran tiketRujukan anda sendiri, kod tempahan, tarikh akhir, data penumpang tepat seperti dihantarTimeout tanpa jawapan; PNR berganda; nama ditolak
Keluarkan tiketNombor e-tiket; di sinilah wang benar-benar terikatSetiap nombor tiket, dipadankan dengan penumpang dan segmennyaPengeluaran separa; reservasi dibatalkan syarikat penerbangan kerana tarikh akhir berlalu

Baris yang paling banyak dipertikaikan ialah yang ketiga, kerana banyak API membenarkan tempah dan keluarkan tiket dalam satu panggilan. Gunakanlah. Dalam dunia syarikat penerbangan kedua-duanya tetap berasingan: PNR boleh wujud tanpa tiket, dan pengeluaran tiket boleh gagal selepas PNR dicipta. Endpoint gabungan hanya menyembunyikan saat satu berjaya dan satu lagi tidak, jadi model data anda masih perlukan tempat untuk keadaan itu.

Perhatikan juga apa yang carian tidak pulangkan: janji. Ia iklan. Langkah semak harga ialah sebut harga, dan hanya tiket yang merupakan jualan.

Kenapa harga carian bukan harga yang anda tempah

Pembangun web menjangkakan katalog. Inventori syarikat penerbangan bukan katalog. Satu penerbangan dijual dalam kelas tempahan, setiap satu baldi tempat duduk pada satu tambang, dan syarikat penerbangan membuka dan menutup baldi itu secara berterusan apabila pesawat semakin penuh. Hasil carian dihimpun dengan cepat daripada ketersediaan yang mungkin sudah sedikit ketinggalan; semasa pengguna selesai menaip dua pasport, kelas paling murah pada penerbangan itu mungkin sudah ditutup. Langkah semak harga bertanya semula, dan jawapan jujurnya kadang-kadang lebih tinggi.

Cukai menambah anjakannya sendiri. Ia dikira semula semasa semak harga untuk penumpang dan laluan yang tepat, dan kanak-kanak atau bayi berharga lain daripada dewasa yang diandaikan oleh carian. Jika kedai anda memaparkan ringgit sedangkan pembekal menyebut harga dalam mata wang lain, penukaran mata wang ialah satu lagi tempat angka bergerak.

Akibat reka bentuknya mudah dan sering terlepas: jangan sekali-kali caj berdasarkan harga carian. Jalankan semak harga sebelum pembayaran, bandingkan, dan jika jumlahnya berubah, tunjukkan angka baharu dan minta persetujuan. Apa jua markup mesti dikira semula daripada tambang baharu, bukan dibawa dari halaman hasil — logiknya sama seperti yang dilalui agensi ketika menetapkan strategi markup dalam talian, dan ia rosak dengan cara yang sama apabila asasnya beralih.

Idempotensi, dan maksud timeout semasa tempahan

Bahagian ini patut dibaca dua kali.

Apabila panggilan tempahan timeout, anda tidak tahu apa yang berlaku. Permintaan mungkin tidak pernah sampai. Mungkin sampai dan gagal. Atau — kes yang menyakitkan — ia sampai, pembekal mencipta PNR dengan syarikat penerbangan, dan respons hilang dalam perjalanan pulang. Bagi kod anda, ketiga-tiganya kelihatan sama. Bagi syarikat penerbangan, yang ketiga ialah reservasi hidup yang memegang tempat duduk atas nama pelanggan anda.

Refleks daripada integrasi lain ialah cuba semula. Di sini, cubaan semula secara buta boleh menghasilkan PNR kedua untuk penumpang yang sama pada penerbangan yang sama. Syarikat penerbangan menganggap tempahan berganda sebagai pelanggaran polisi; bergantung pada syarikat dan perjanjian agensi, akibatnya daripada pembatalan automatik satu atau kedua-dua reservasi hingga memo debit — ADM — yang dihantar kepada pihak yang mengeluarkannya. Agensi yang menerimanya akan mahu tahu kenapa sistem anda menempah dua kali.

Apa yang berkesan, lebih kurang mengikut urutan ini:

  • Cipta rujukan tempahan sendiri sebelum membuat panggilan, simpan, dan hantar bersama permintaan di mana sahaja API menerima rujukan klien. Jika API menyokong kunci idempotensi, gunakannya; jika tidak, rujukan anda tetap cara untuk mencari tempahan itu kemudian.
  • Modelkan keadaan tidak diketahui secara eksplisit. Menunggu, disahkan, gagal — dan tidak diketahui. Timeout memindahkan tempahan ke tidak diketahui, bukan ke gagal.
  • Selesaikan keadaan tidak diketahui dengan bertanya, bukan mengulang. Dapatkan tempahan mengikut rujukan anda, atau senaraikan tempahan terkini untuk penumpang tersebut, sebelum memutuskan untuk mencuba lagi.
  • Jalankan kerja penyesuaian yang menyapu apa sahaja yang masih tidak diketahui, membandingkannya dengan laporan pembekal, dan menghantar yang tidak dapat diselesaikan ke baris gilir manusia, bukannya meneka.

Timeout pengeluaran tiket ialah masalah yang sama tetapi melibatkan wang. Jika anda caj kad sebelum pengeluaran dan pengeluaran tergantung, anda ada pelanggan yang sudah bayar dan mungkin tiada tiket. Jika anda keluarkan tiket sebelum caj dan caj gagal, anda telah mengeluarkan dokumen yang perlu dibayar seseorang kepada syarikat penerbangan. Bentuk biasa ialah membenarkan (authorise) kad dahulu, keluarkan tiket, kemudian capture apabila berjaya — yang penting ialah memutuskannya dengan sengaja, bukan menemuinya di produksi.

Konsep penerbangan yang mengejutkan pembangun web

Tiada satu pun yang sukar. Setiap satu pernah menghabiskan seminggu seseorang kerana dia tidak tahu ia wujud.

PNR bukan tiket

PNR ialah rekod reservasi: penumpang, segmen, kenalan, tarikh akhir. Tiket ialah dokumen berbayar yang memberi hak untuk terbang. PNR tanpa tiket tamat pada tarikh akhirnya dan tempat duduk kembali dijual, kadang-kadang secara senyap dari sudut anda.

Nama hampir tidak boleh diubah

Selepas tiket dikeluarkan, kebanyakan tambang tidak membenarkan tukar nama melebihi pembetulan kecil, dan apa yang dikira kecil berbeza antara syarikat penerbangan. Nama mesti sepadan dengan dokumen perjalanan. Kumpul nama keluarga dan nama diberi secara berasingan — berhati-hati dengan nama yang mengandungi "bin" atau "binti", kerana pembekal berbeza cara mengendalikannya — jangan biarkan gelaran daripada teks bebas masuk ke medan nama, dan sahkan sebelum panggilan tempah, bukan selepasnya.

Jenis penumpang ada harga, bukan hiasan

Dewasa, kanak-kanak dan bayi ialah jenis tambang, dan umur yang menentukan biasanya umur pada tarikh perjalanan, bukan tarikh tempahan. Bayi di riba lazimnya tidak menduduki tempat duduk dan hanya boleh terbang bersama orang dewasa. Silap jenis, maka semak harga sama ada gagal atau menyebut tambang yang salah.

Masa adalah tempatan, dan segmen bukan leg

Masa berlepas dan tiba diberi dalam waktu tempatan setiap lapangan terbang. Jangan tukarkan ke zon waktu pengguna untuk paparan, dan jangan kira tempoh dengan menolaknya tanpa offset. Perjalanan mengandungi segmen; segmen dengan hentian teknikal mengandungi lebih daripada satu leg. UI dan data anda perlu bersetuju yang mana satu dipanggil "hentian".

Perkara berlaku selepas jualan

Syarikat penerbangan menukar jadual selepas tiket dikeluarkan. Tempahan yang betul semasa pengeluaran boleh menunjukkan masa baharu, nombor penerbangan baharu atau sambungan yang terputus beberapa minggu kemudian, dan bergantung pada pembekal anda mengetahuinya melalui notifikasi, baris gilir atau dengan mengambil semula tempahan. Rancang supaya tempahan berubah selepas anda berhenti melihatnya.

Void bukan bayaran balik

Sejurus selepas pengeluaran biasanya ada tetingkap masa di mana tiket boleh di-void seolah-olah tidak pernah wujud. Selepas itu, hanya bayaran balik mengikut peraturan tambang yang mungkin, dan ia boleh dikenakan penalti atau tidak memulangkan apa-apa. Tetingkap dan peraturannya milik pembekal dan perjanjian pengeluaran; bacanya sebelum anda membina butang "batal".

Kos sebuah kesilapan

Kegagalan dalam integrasi penerbangan mahal dengan cara yang khusus: ia jatuh kepada manusia, bukan ke log. Tempahan berganda menjadi panggilan telefon kepada syarikat penerbangan dan mungkin memo terhadap akaun agensi. Pelanggan yang dicaj tanpa tiket menjadi bayaran balik, aduan dan risiko chargeback. Tiket yang dikeluarkan tanpa pembayaran berjaya menjadi hutang kepada syarikat penerbangan yang perlu dijelaskan seseorang. Perubahan jadual yang tidak diproses menjadi penumpang di lapangan terbang untuk penerbangan yang sudah berlepas lebih awal.

Tiada satu pun muncul dalam ujian laluan gembira. Tulis laluan tidak gembira dahulu: timeout semasa tempah, harga yang naik, tiket yang gagal selepas PNR wujud, void selepas pembayaran berjaya. Jika semua itu dikendalikan, laluan gembira ialah bahagian yang mudah.

Menguji terhadap API penerbangan

Persekitaran ujian pembekal berguna tetapi tidak lengkap. Ia lazimnya lebih sunyi daripada produksi, jadi kelas habis dijual dan perubahan harga lebih jarang, dan sesetengahnya langsung tidak mensimulasikan timeout. Gunakannya untuk bentuk panggilan dan ralat pengesahan, kemudian rancang larian terkawal di produksi dengan tempahan sebenar yang anda void dalam tetingkap masa — dengan pengetahuan bahagian operasi.

Sama ada perlu berintegrasi sama sekali ialah soalan berasingan. Jika yang anda perlukan sebenarnya kedai dalam talian dan bukan inventori mentah dalam sistem sendiri, pertimbangannya dihuraikan dalam white label atau bina enjin tempahan sendiri, dan penaakulan yang sama terpakai untuk portal B2B untuk subejen. Jika anda memang mahu inventori itu dalam kod sendiri, platform ini menyediakan API penerbangan dan hotel, dan akses bermula dengan perbualan tentang kegunaan anda, bukan kunci layan diri — saat yang sesuai juga untuk bertanya setiap soalan di atas.

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.