Langkau ke kandungan
Blog

Pengendalian ralat API enjin tempahan: tiga kegagalan yang memakan kos

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Tiket sokongan masuk pada petang Khamis. Pelanggan sudah membayar, halaman berpusing, kemudian memaparkan ralat umum. Kad telah dicaj. Log anda menunjukkan satu POST ke pembekal yang tidak pernah mendapat jawapan. Adakah syarikat penerbangan menahan tempat duduk? Tiada siapa boleh beritahu, dan pelanggan sedang menunggu. Pengendalian ralat API enjin tempahan yang baik kebanyakannya ialah kerja memastikan anda tidak pernah berada dalam kedudukan itu, atau sekurang-kurangnya tahu dengan tepat apa yang perlu dibuat apabila ia berlaku.

Kebanyakan panduan integrasi menganggap ralat sebagai katalog kod status. Dalam tempahan, kod status ialah bahagian yang mudah. Yang memakan kos ialah segelintir situasi di mana permintaan nampak gagal tetapi dunia sebenar telah berubah, atau nampak berjaya tetapi dunia sebenar tidak berubah. Tiga daripadanya lebih penting daripada yang lain.

Kegagalan pertama: harga berubah antara carian dan tempahan

Hasil carian ialah sebut harga, bukan kontrak. Tambang di-cache, inventori dikongsi merentas semua saluran yang dijual pembekal, dan nombor yang anda tunjukkan pada 14:02 mungkin sudah lapuk beberapa minit kemudian. Pembekal memberitahu anda pada langkah create-booking, kadangkala dengan respons jelas "fare changed", kadangkala dengan senyap memulangkan jumlah berbeza dalam respons yang nampak berjaya.

Jenis kedua yang berbahaya. Jika kod anda membaca pengesahan, menyimpan tempahan dan mengenakan bayaran sebanyak yang pelanggan lihat, perbezaannya keluar daripada margin anda, atau kemudian daripada ADM. Jadi peraturannya mudah: bandingkan jumlah yang disahkan pembekal dengan jumlah yang diterima pelanggan, setiap kali, dalam kod, sebelum anda menangkap bayaran.

Apa yang dibuat apabila berbeza bergantung pada saiz jurang dan siapa yang menanggungnya. Beberapa sen pembundaran antara mata wang ialah toleransi yang anda tetapkan sekali. Apa-apa yang lebih besar kembali kepada pelanggan sebagai harga baharu dengan butang terima yang jelas. Jangan sekali-kali serap secara automatik, dan jangan sekali-kali caj secara automatik.

Kegagalan kedua: sudah ditempah, tetapi tiket belum dikeluarkan

Kewujudan PNR tidak sama dengan kewujudan tiket. Banyak aliran mencipta tempahan dahulu dan mengeluarkan e-tiket sebagai langkah berasingan, dengan had masa di antaranya. Jika bayaran berjaya dan pengeluaran gagal, anda memegang wang pelanggan dan tempahan yang akan tamat tempoh mengikut jamnya sendiri.

Kegagalan ini jarang bising. Panggilan issue memulangkan ralat atau tamat masa, dan tempahan berada dalam keadaan yang pangkalan data anda labelkan "paid" sedangkan pembekal masih menyebut "held". Sementara itu had masa ticketing berjalan, dan tidak seperti baris gilir sokongan anda, syarikat penerbangan tidak menunggu.

Kendalikannya sebagai keadaan tersendiri, bukan varian kejayaan atau kegagalan. Tempahan memerlukan sekurang-kurangnya keadaan ini: created, held, payment captured, issuing, ticketed, failed-and-refundable. "Payment captured, issuing" ialah keadaan yang memerlukan pemasa: apabila tempahan terlalu lama di situ, satu job harus membaca semula tempahan daripada pembekal dan membuat keputusan, bukan menunggu manusia perasan. Keputusan itu murah apabila anda tahu had masa pembekal, kerana ia memberitahu berapa lama anda boleh cuba semula dengan selamat sebelum perlu memulangkan bayaran.

Kegagalan ketiga: tamat masa dengan hasil yang tidak diketahui

Inilah tiket petang Khamis tadi. Permintaan anda keluar, tiada respons kembali, sambungan terputus atau gateway mengalah. Pembekal mungkin telah memprosesnya sepenuhnya, separa, atau langsung tidak.

Godaannya ialah mencuba semula. Jangan cuba semula panggilan create-booking secara buta, kerana percubaan kedua boleh menghasilkan tempahan kedua, dan pendua ialah kos sebenar: dua tempat duduk ditahan, mungkin dua tiket dikeluarkan, dan pertikaian bayaran balik pada salah satunya.

Urutan selamat: berhenti, baca, kemudian putuskan. Hentikan aliran di sisi pelanggan dengan keadaan jujur "kami sedang mengesahkan tempahan anda". Baca sisi pembekal dengan mencari tempahan menggunakan rujukan yang anda jana sebelum panggilan (inilah sebabnya anda mencipta rujukan klien sendiri dahulu dan menghantarnya jika pembekal menerimanya). Hanya selepas itu putuskan: dijumpai bermaksud teruskan dari keadaan sebenar; tidak dijumpai selepas tetingkap pemprosesan pembekal bermaksud selamat untuk cuba semula sekali.

Jika pembekal tidak memberi cara mencari melalui rujukan anda, cari mengikut nama penumpang, laluan dan tarikh dalam tetingkap sempit, dan anggap padanan sebagai dijumpai. Hodoh, tetapi jauh lebih murah daripada pendua.

Jadual keputusan yang boleh anda bangkang

Apa yang anda lihatApa yang anda tahuApa yang perlu dibuatApa yang tidak boleh dibuat
Pembekal memulangkan "fare changed"Tiada apa ditempahTunjuk jumlah baharu, minta persetujuan, jalankan semula createJalankan semula dengan harga lama dan berharap lulus
Berjaya, tetapi jumlah berbeza daripada yang diterima pelangganTempahan wujud pada harga baharuTahan bayaran, tanya pelanggan, batalkan tempahan jika menolakTangkap jumlah lama dan tanggung beza
Bayaran ditangkap, panggilan issue ralatPNR wujud, status tiket tidak diketahuiBaca semula tempahan, cuba issue dalam had masa, bayar balik selepas ituTanda tempahan gagal dan lupakan PNR
Tamat masa pada createHasil tidak diketahuiCari dengan rujukan anda, kemudian teruskan atau cuba semula sekaliCuba semula buta serta-merta
Tamat masa pada cancelAnda mungkin masih bertanggungjawab atas segmenBaca semula status sebelum memberitahu pelanggan apa-apaPapar "cancelled" kerana butang sudah diklik

Satu baris yang mungkin anda bangkang: sesetengah pasukan membayar balik pada ralat pengeluaran pertama untuk menenangkan pelanggan. Itu boleh dipertahankan untuk tiket murah dan tabiat buruk untuk tiket mahal, kerana anda boleh kehilangan tambang yang semenit kemudian masih boleh diselamatkan.

Berapa kosnya jika tersilap

Setiap kegagalan ada bil berbeza. Perubahan harga yang terlepas ialah margin hilang pada setiap tempahan yang terkesan, selalunya tidak disedari sehingga perdamaian. Booked-not-ticketed ialah pelanggan yang tiba di lapangan terbang dengan tempahan yang telah luput dan caj pada kadnya, iaitu chargeback dan masalah reputasi serentak. Cuba semula buta ketika tamat masa ialah tempahan pendua, dan syarikat penerbangan mengaudit pendua; corak kes sebegitu ialah jenis perkara yang berakhir dengan ADM.

Tiada satu pun ini luar biasa. Ia kerja paip yang tidak glamor yang membezakan demo daripada sesuatu yang boleh anda biarkan berjalan sepanjang hujung minggu.

Bina job perdamaian sebelum anda memerlukannya

Ketiga-tiga kegagalan berakhir sama: pangkalan data anda dan pembekal tidak sependapat. Jadi tulis job yang membandingkannya sebelum insiden pertama, bukan selepas. Larian malam ialah minimum; setiap beberapa minit untuk apa-apa dalam keadaan peralihan lebih baik. Ia menyenaraikan tempahan yang tersangkut dalam held, issuing atau unknown, bertanya pembekal, kemudian membetulkan rekod atau membuka tiket dengan bukti dilampirkan.

Simpan setiap permintaan dan respons untuk panggilan tempahan, termasuk tamat masa, bersama rujukan yang anda hantar. Apabila pelanggan mempertikaikan caj, log itu ialah hujah anda. Ia juga memastikan perbincangan latensi jujur: lihat apa yang boleh dan tidak boleh anda baiki tentang latensi API untuk sebab tamat masa ialah realiti hidup, bukan pepijat untuk dihapuskan.

Jika anda masih memutuskan cara menyambung pembekal itu sendiri, panduan dalam integrasi API tempahan penerbangan meliputi urutan panggilan yang diandaikan artikel ini. Dan jika anda mahu berbincang bagaimana keadaan ini dipetakan ke API penerbangan dan hotel kami, akses bermula dengan perbualan: lihat halaman API pelancongan.

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.