Langkau ke kandungan
Blog

Perbandingan API pelancongan: nilai paksinya, bukan vendor

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Anda membuka tiga dek vendor dalam tiga tab. Setiap satu ada slaid dengan senarai syarikat penerbangan yang panjang, slaid jumlah hotel, sandbox, REST dan JSON, serta e-mel sokongan. Anda membina hamparan, menanda setiap sel, dan hamparan itu berakhir seri. Itulah kesudahan biasa perbandingan API pelancongan yang dibuat sebagai senarai semak ciri — dan ia kesudahan yang salah, kerana perbezaan yang akan menentukan tahun depan anda hanya muncul selepas go-live: pada tempahan yang berjaya di pihak pembekal tetapi tamat masa di pihak anda, pada bayaran balik yang tiada siapa boleh proses, pada syarikat penerbangan yang ada dalam senarai tetapi tiketnya tidak boleh dikeluarkan melalui laluan ini.

Tulisan ini untuk pembangun atau ketua teknikal yang perlu membuat keputusan itu dan mempertahankannya kemudian. Ia tidak menyusun kedudukan vendor. Ia memberi anda paksi untuk dibandingkan, pelan percubaan yang menghabiskan masanya pada kegagalan, dan beberapa soalan ringkas yang cepat memberitahu sama ada anda sedang bercakap dengan pembekal atau dengan penjual semula pembekal orang lain.

Mengapa senarai semak ciri sentiasa berakhir seri

Senarai semak bertanya sama ada sesuatu keupayaan wujud. Hampir setiap API pelancongan boleh menjawab ya pada hampir setiap baris, kerana barisnya ditulis pada tahap halaman pemasaran: carian, harga, tempahan, pembatalan, pengeluaran tiket, webhook, sandbox. Soalan yang membezakan mereka bukan sama ada cancel wujud, tetapi apa yang berlaku apabila anda memanggilnya pada tempahan yang sudah dikeluarkan tiket dua belas jam sebelum berlepas, pada tambang yang dikenakan penalti, melalui laluan yang kandungannya datang daripada pihak ketiga. Senarai semak tidak ada lajur untuk itu.

Ada masalah kedua. Yang mengisi senarai semak biasanya vendor itu sendiri. Anda sedang menilai gambaran diri mereka.

Perbandingan API pelancongan berasaskan paksi, bukan vendor

Gantikan grid vendor-darab-ciri dengan paksi yang anda nilai sendiri, daripada bukti yang dikumpul semasa percubaan. Jadual di bawah ialah yang akan kami gunakan. Anda boleh memberi pemberat berbeza pada setiap baris — perniagaan yang hanya menjual hotel kurang peduli tentang pengeluaran tiket — dan anda patut berdebat dengannya dahulu sebelum menerimanya.

PaksiApa yang ditanya senarai semakApa yang sebenarnya perlu diketahuiBunyi jawapan yang lemah
LiputanBerapa syarikat penerbangan dan hotel?Berapa yang boleh dicari, ditempah DAN dikeluarkan tiket atau disahkan melalui API ini, untuk pasaran andaSatu angka besar tanpa pecahan
KedalamanAda endpoint pembatalan?Tindakan selepas tempahan yang diautomasikan bagi setiap sumber kandungan: void, bayaran balik, reissue, pembetulan nama, ancillary"Pasukan operasi kami yang uruskan"
Integriti hargaAdakah harga masa nyata?Berapa kerap harga semasa tempahan berbeza daripada harga semasa carian, dan bagaimana API memberitahu anda"Harga sentiasa live"
Semantik ralatAdakah ralat didokumenkan?Sama ada ralat memberitahu status tempahan, bukan sekadar ada yang gagalSatu kod ralat umum untuk semua kegagalan
Idempotensi—Sama ada panggilan tempahan yang diulang boleh mencipta tempahan keduaSenyap, kemudian "kami belum pernah nampak itu"
Supplier of record—Kontrak siapa, nombor IATA siapa, BSP siapa yang dilalui tiket"Kami bekerjasama dengan semua GDS utama"
Akses dan sokonganAda sandbox?Siapa yang menjawab apabila PNR live tersekat, dan berapa pantasBorang tiket tanpa nama kenalan

Dua daripada baris itu langsung tiada soalan dalam senarai semak. Itu bukan kebetulan: merekalah baris yang paling mahal apabila salah, dan yang paling kurang mungkin didedahkan sendiri oleh dek vendor.

Liputan bukan kedalaman

Senarai syarikat penerbangan ialah slaid paling mengelirukan dalam mana-mana dek. Senarai beberapa ratus syarikat penerbangan boleh bermaksud beberapa perkara berbeza, dan hanya satu yang anda mahukan.

Sebahagiannya datang melalui GDS dan boleh ditempah serta dikeluarkan tiket dari awal hingga akhir. Sebahagian melalui sambungan NDC, di mana carian mungkin berfungsi baik tetapi servis selepas tempahan — perubahan, bayaran balik separa, tambah bagasi — mungkin masih manual bagi syarikat penerbangan itu. Sebahagian lagi syarikat penerbangan tambang rendah yang kandungannya diagregat daripada penjual semula lain; anda boleh memaparkannya, kadangkala boleh menempahnya, kemudian tiket tiba melalui laluan yang anda tidak kawal, dengan tempoh yang anda tidak boleh janjikan kepada pelanggan. Dan ada yang tersenarai hanya kerana satu tambang pernah muncul dalam respons carian.

Syarikat penerbangan yang boleh anda paparkan tetapi tidak boleh keluarkan tiket bukan liputan. Bagi produk runcit ia lebih teruk daripada tiada langsung, kerana pelanggan memilihnya, membayar, kemudian menunggu.

Hotel mempunyai bentuk yang sama dengan istilah berbeza. Jumlah hartanah merangkumi yang sudah dipetakan vendor dan yang belum; kadar statik yang di-cache minggu lepas bersebelahan dengan ketersediaan live; bilik allotment dengan release period bersebelahan dengan inventori free-sale. Minta angka yang benar-benar boleh ditempah secara live di bandar yang anda jual, dan tanya bagaimana pendua merentas pembekal mereka sendiri digabungkan — hotel yang sama muncul tiga kali dengan tiga harga ialah tiket sokongan yang menunggu masa.

Ujian praktikalnya sempit. Tulis dua puluh laluan dan dua puluh bandar hotel yang membentuk sebahagian besar volum anda, dan minta vendor menunjukkan semua itu berfungsi dari awal hingga akhir dalam sandbox: cari, harga, tempah, keluarkan tiket atau sahkan, batal. Vendor yang ada kedalaman akan melakukannya tanpa banyak karenah. Vendor yang hanya ada slaid akan mula bercakap tentang slaid.

Apa yang diuji semasa percubaan: laluan ralat, bukan laluan lancar

Setiap sandbox berjaya menempah tiket ekonomi sehala di laluan yang lengang. Itulah tujuan sandbox dibina. Trafik produksi anda akan menghabiskan sebahagian besar hayatnya di laluan lain, dan percubaan ialah satu-satunya masa murah untuk melihatnya.

Gunakan percubaan untuk menjalankan senarai ini, dan catat apa yang dipulangkan API di sebelah apa yang sebenarnya benar selepas itu:

  • Harga berubah antara carian dan tempahan. Adakah panggilan tempahan gagal, berjaya pada harga baharu, atau memulangkan respons khas yang meminta pengesahan? Bolehkah UI anda membezakannya tanpa menghurai teks mesej?
  • Tawaran tamat tempoh. Cari, tunggu lebih lama daripada hayat tawaran vendor, kemudian tempah. Adakah tamat tempoh itu ralat khusus, atau sama dengan ralat "pembekal tidak tersedia"?
  • Habis dijual semasa tempahan. Inventori yang hilang antara harga dan tempahan. Apakah status tempahan, dan adakah kebenaran pembayaran dilepaskan?
  • Cuba semula selepas timeout. Hantar permintaan tempahan, putuskan sambungan sebelum respons, kemudian hantar lagi. Kini anda ada satu PNR atau dua? Ujian yang satu ini memberitahu lebih banyak tentang vendor daripada seluruh percubaan digabungkan.
  • Tempahan dicipta, pengeluaran tiket gagal. Bolehkah API melaporkan PNR yang wujud tetapi belum dikeluarkan tiket, dan adakah ia memberitahu tarikh akhir pengeluaran tiket?
  • Kegagalan separa. Permintaan hotel berbilang bilik di mana satu bilik disahkan dan satu tidak. Pergi-balik di mana penerbangan pergi dan pulang datang daripada sumber berbeza.
  • Pembatalan di luar tempoh percuma. Adakah penalti dinyatakan sebelum anda mengesahkan, atau ditemui pada invois?
  • Gangguan pembekal. Tanya vendor cara mensimulasikannya. Jika tidak boleh, tanya bagaimana pelanggan mereka mengetahui kelakuannya.

Bagi setiap kes anda menilai dua perkara. Pertama, adakah API memberitahu kebenaran tentang status tempahan? Kedua, bolehkah kod anda bertindak atas kebenaran itu tanpa manusia membaca teks bebas? API yang gagal dengan jelas lebih mudah dihadapi berbanding yang berjaya secara kabur.

Kami menulis dengan lebih terperinci tentang bahagian penerbangan dalam apa yang tidak disebut dokumentasi API tempahan penerbangan, dan tentang mereka bentuk klien untuk pembekal hotel yang perlahan dalam artikel ketersediaan hotel. Kedua-duanya teman berguna untuk pelan percubaan.

Soalan yang mendedahkan agregator nipis

Tiada salahnya dengan agregator. Kebanyakan kandungan pelancongan sampai kepada kebanyakan penjual melalui agregator. Risikonya ialah yang nipis: lapisan yang menjual semula API lapisan lain, menambah margin, dan tidak memiliki kontrak pembekal mahupun meja operasi. Apabila sesuatu rosak, jawapannya perlu melalui dua syarikat ke hulu dan kembali.

Lima soalan mendedahkannya dengan cepat:

  1. Siapa supplier of record untuk tempahan ini? Kontrak siapa dengan syarikat penerbangan atau hotel yang menjadi asasnya?
  2. Nombor IATA dan BSP siapa yang dilalui tiket? Jika jawapannya "milik rakan kongsi", tanya siapa yang menerima ADM apabila peraturan tambang dilanggar.
  3. Apabila saya memanggil cancel, apa yang berlaku di pihak anda? Panggilan automatik kepada pembekal, atau baris gilir yang diambil oleh orang?
  4. Bolehkah saya melihat ralat dari hulu? Lapisan nipis cenderung meratakan semua kegagalan menjadi satu kod, kerana ia tidak memahami sepenuhnya ralat yang diterima.
  5. Siapa yang saya hubungi tentang tempahan live yang tersekat, dan siapa yang mereka hubungi? Kira lompatannya.

Tiada satu pun jawapan ini menggugurkan dengan sendirinya. Nombor IATA rakan kongsi boleh jadi baik jika kontrak jelas menyatakan siapa menanggung memo debit. Yang penting, vendor menjawab dengan tepat dan cepat. Jawapan kabur di sini ialah jawapan yang akan anda terima kemudian, dalam produksi, pada waktu yang lebih buruk.

Kos jika tersilap pilih

Integrasi ialah bahagian yang murah. Bahagian yang mahal tiba kemudian dan tidak muncul dalam mana-mana anggaran.

Pepijat tempahan berganda bermaksud pelanggan dicaj dua kali dan PNR yang perlu anda cari serta batalkan secara manual, mungkin selepas tempoh void percuma tamat. Tempahan yang berjaya di hulu sedangkan pihak anda merekodkan kegagalan bermaksud tempat duduk ditahan, kemudian dibatalkan automatik, dan pelanggan yang percaya mereka sudah ditempah. Syarikat penerbangan yang anda paparkan tetapi tidak boleh dikeluarkan tiket bermaksud bayaran balik, permohonan maaf dan pelanggan yang tidak kembali. ADM untuk peraturan tambang yang dilanggar oleh laluan vendor jatuh kepada pemilik tiket — pastikan awal-awal sama ada itu anda.

Kemudian ada kos bertukar. Setiap keanehan vendor yang anda serap — kod status yang membawa dua maksud, medan yang kadangkala rentetan — berakhir dalam model data anda. Dua tahun kemudian, pilihan API bukan lagi integrasi yang boleh diganti dalam satu sprint; ia sudah menjadi bentuk jadual tempahan anda. Itulah sebab sebenar untuk membandingkan dengan teliti sekarang.

Di mana API kami dalam rangka ini

Kami menyediakan API penerbangan dan hotel. Akses bermula dengan perbualan, bukan kunci layan diri, dan sesetengah pembangun menganggapnya perlahan; sebabnya, perbualan itulah tempat soalan-soalan di atas ditanya dari kedua-dua arah — laluan dan bandar mana yang anda perlukan, kandungan mana yang benar-benar boleh anda keluarkan tiket atau sahkan, dan siapa mengurus apa selepas tempahan. Jika anda sedang membuat perbandingan, bawa senarai ini. Perbualan itu bermula di halaman API pelancongan.

Apa pun pilihan anda, pilihlah berdasarkan log percubaan, bukan dek. Dek memberitahu apa yang vendor mahu jadi. Laluan ralat memberitahu apa vendor itu sebenarnya.

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.