Langkau ke kandungan
Blog

API tempahan hotel dan penerbangan: satu perjalanan, dua tempahan

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Tiketnya berbunyi: "tambah hotel ke aliran penerbangan, satu checkout, satu jumlah". Permintaan yang munasabah daripada pengurus produk, dan bunyinya seperti kerja sehari, kerana anda sudah ada carian penerbangan dan sudah ada halaman pembayaran. Tiga minggu kemudian pasukan bertengkar tentang apa yang patut berlaku apabila syarikat penerbangan mengesahkan dan hotel tidak. API tempahan hotel dan penerbangan bukan satu integrasi dengan dua jenis keputusan. Ia dua integrasi yang berkongsi satu bakul.

Lebih cepat kod mengakuinya, lebih sedikit yang perlu ditulis semula. Berikut bahagian yang dilangkau panduan integrasi: bagaimana kedua-dua separuh berbeza, yang mana perlu dikunci dahulu, dan apa yang mesti menjadi sebuah perjalanan dalam model data anda.

Kedua-dua separuh tidak berkelakuan sama

Kedua-duanya kembali sebagai JSON dengan harga dan rujukan, jadi di rangkaian ia nampak serupa. Ia tidak serupa dari segi apa yang dijanjikan sebaik rujukan itu di tangan anda.

SoalanPenerbanganHotel
Apa yang anda pegang selepas tempahanTempahan (PNR) yang belum lagi tiketPengesahan yang biasanya sudah pun perkara yang anda jual
Berapa lama harga sahSehingga tambang dikira semula semasa tempahan, yang boleh berbeza daripada carianSehingga kadar tamat, dan kadar boleh berubah antara ketersediaan dan tempahan
Apa yang mengesahkannyaPengeluaran tiket, selalunya dengan had masaPengesahan pembekal, kadang-kadang serta-merta, kadang-kadang menunggu
Bagaimana ia dibatalkanVoid jika dikesan awal, jika tidak bayaran balik mengikut peraturan tambang, selalunya dengan penaltiPembatalan mengikut polisi kadar itu sendiri, percuma sehingga tarikh akhir bagi banyak kadar
Apa yang mengubah angka pada saat akhirTambang, cukai, kadang-kadang mata wang tambangCukai dan yuran yang dibayar di hartanah, jenis makanan, bilik yang sebenarnya diberikan

Anda boleh tidak bersetuju dengan satu baris, kerana pembekal berbeza-beza, tetapi bukan dengan bentuknya: satu separuh ada langkah pengeluaran tiket dan satu lagi ada tetingkap pembatalan, dan ia tidak sejajar dari segi masa. Sisi penerbangan telah kami bincangkan dalam integrasi API tempahan penerbangan, dan masalah pembekal perlahan di sisi hotel dalam reka bentuk klien API ketersediaan hotel. Tulisan ini bermula di tempat kedua-duanya berakhir, di sambungan.

Yang mana ditempah dahulu?

Tiada siapa memberitahu anda bahawa ini keputusan reka bentuk, dan inilah keputusan yang menentukan kos sesuatu kegagalan.

Katakan pelanggan membeli penerbangan dan hotel untuk tarikh yang sama. Anda menghantar satu tempahan dan kemudian yang lain. Tiga perkara boleh berlaku: kedua-duanya berjaya, atau satu gagal, atau satu gagal selepas yang lain sudah berjaya. Yang pertama ialah hari yang baik. Dua lagi menentukan barisan sokongan anda.

Jika anda mengeluarkan tiket penerbangan dahulu dan hotel kemudian menolak, anda ada pelanggan dengan tempat duduk ke sebuah bandar tanpa bilik, yang sudah dicaj, dan bayaran balik untuk tiket yang dikenakan penalti. Jika anda menempah hotel dahulu dan penerbangan kemudian gagal, anda memegang bilik yang selalunya boleh dibatalkan secara percuma, jadi pembaikannya murah. Risiko sebaliknya juga nyata, kerana kadar hotel yang tidak boleh dibatalkan ialah perkara yang lebih teruk untuk dipegang, jadi baca syarat pembatalan kadar itu sebelum membiarkannya pergi dahulu.

Ini panduan kasar, bukan undang-undang, dan intinya anda memilih urutan dengan sengaja. Kunci separuh yang lebih mudah dibatalkan sebelum yang lebih sukar, semak harga kedua-duanya sejurus sebelum mana-mana satu dikunci, dan tulis apa yang anda lakukan bagi setiap tiga hasil itu. Penyemak jarang bertanya. Pelanggan sentiasa tahu.

Satu perjalanan, dua tempahan

Bentuk yang bertahan ialah rekod perjalanan yang memiliki dua tempahan, setiap satu dengan rujukan, status dan syaratnya sendiri. Pelanggan melihat satu jumlah. Pangkalan data melihat dua baris, dan jumlah itu ialah hasil tambah yang anda kira, bukan sesuatu yang wujud di pihak pembekal.

Asingkan kedua-dua status. "Disahkan" untuk hotel dan "tiket dikeluarkan" untuk penerbangan bukan keadaan yang sama, dan satu lajur status yang meratakan kedua-duanya lambat-laun akan menulis "ditempah" pada perjalanan yang baru separuh ditempah.

Asingkan juga kedua-dua set syarat perubahan, dan paparkannya. Jumlah yang dipaparkan menyembunyikan bahawa mengalih tarikh ialah perubahan percuma pada satu separuh dan berbayar pada separuh lagi. Jika frontend memaparkan "tukar tarikh" sebagai satu butang, putuskan apa yang dilakukannya apabila hanya satu separuh boleh dialih, sebelum pelanggan mengetahuinya untuk anda. Perkara yang sama untuk markup: jika anda menambahnya bagi setiap perkhidmatan, seperti kebanyakan penjual, jumlah perjalanan ialah dua markup, dan bayaran balik untuk satu separuh perlu tahu markup mana yang dipulangkan. Wang ialah tempat perjalanan gabungan menjadi mahal, kerana setiap baris diselesaikan mengikut garis masa berbeza, dan bayaran balik penerbangan tidak tiba serentak dengan pembatalan hotel.

Di mana platform ini berdiri

Terus terang: platform ini menyediakan API penerbangan dan hotel, dan akses bermula dengan perbualan, bukan kunci layan diri. Perkhidmatan dihidupkan bagi setiap tenant, jadi tenant yang menjual hotel dan bukan lawatan tidak membawa permukaan lawatan. Tiada apa-apa di sini yang menjanjikan satu panggilan yang menempah kedua-dua separuh secara atomik, dan anda tidak patut mereka bentuk seolah-olah ada. Layan kedua-duanya sebagai dua tempahan, sebagaimana adanya, di bawah perjalanan yang anda miliki.

Jika anda mahu melihat panggilan dan syarat sebenar sebelum membina di sekelilingnya, mulakan dari halaman API perjalanan dan bawa urutan tempahan yang anda rancang. Jika anda masih menimbang apa yang diberikan oleh akses percuma, API tempahan hotel percuma menghuraikan jenis-jenis percuma.

Kos jika tersilap

Versi yang mahal ialah yang senyap. Pelanggan sudah ada tiket ke sebuah bandar dan biliknya hilang, dan perkara pertama yang anda dengar ialah mesej pada waktu malam, dari lapangan terbang. Lebih murah tetapi masih nyata: checkout yang memaparkan satu jumlah yang menenangkan dan kemudian, selepas semakan harga, angka kedua yang tidak dipersetujui pelanggan; bayaran balik yang memulangkan penerbangan dan melupakan hotel; dan status "ditempah" sedangkan pembekal berkata sebaliknya.

Semua itu tidak memerlukan penyelesaian yang bijak. Ia memerlukan perjalanan menjadi objek sebenar, urutan menjadi keputusan yang ditulis seseorang, dan semakan semula kedua-dua harga pada saat akhir sebelum mana-mana satu dikunci. Bina itu sekali dan checkout boleh kelihatan semudah yang diminta tiket itu.

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.