Lewati ke konten
Blog

Perbandingan API travel: nilai porosnya, bukan vendornya

Redaksi Tekravel
Ditulis dengan bantuan AI

Anda membuka tiga presentasi vendor di tiga tab. Masing-masing punya slide berisi daftar maskapai yang panjang, slide jumlah hotel, sandbox, REST dan JSON, serta email dukungan. Anda membuat spreadsheet, memberi centang di setiap sel, dan spreadsheet itu berakhir seri. Begitulah biasanya akhir sebuah perbandingan API travel yang dikerjakan sebagai checklist fitur — dan itu akhir yang keliru, karena perbedaan yang akan menentukan tahun depan Anda baru muncul setelah go-live: pada booking yang berhasil di sisi supplier tetapi timeout di sisi Anda, pada refund yang tidak bisa diproses siapa pun, pada maskapai yang ada di daftar tetapi tiketnya tidak bisa diterbitkan lewat rute ini.

Tulisan ini untuk developer atau technical lead yang harus mengambil keputusan itu dan mempertahankannya kelak. Tulisan ini tidak membuat peringkat vendor. Isinya poros untuk membandingkan, rencana trial yang menghabiskan waktunya pada kegagalan, dan beberapa pertanyaan singkat yang cepat memberi tahu apakah Anda sedang bicara dengan supplier atau dengan penjual ulang supplier orang lain.

Mengapa checklist fitur selalu berakhir seri

Checklist bertanya apakah sebuah kemampuan ada. Hampir setiap API travel bisa menjawab ya untuk hampir setiap baris, karena barisnya ditulis setingkat halaman pemasaran: pencarian, harga, booking, pembatalan, penerbitan tiket, webhook, sandbox. Pertanyaan yang membedakan mereka bukan apakah cancel tersedia, melainkan apa yang terjadi ketika Anda memanggilnya pada booking yang sudah ter-issue dua belas jam sebelum keberangkatan, pada tarif yang kena penalti, melalui rute yang kontennya datang dari pihak ketiga. Checklist tidak punya kolom untuk itu.

Ada masalah kedua. Yang mengisi checklist biasanya vendor itu sendiri. Anda sedang menilai deskripsi diri mereka.

Perbandingan API travel berbasis poros, bukan vendor

Ganti tabel vendor-kali-fitur dengan poros yang Anda nilai sendiri, dari bukti yang Anda kumpulkan selama trial. Tabel di bawah adalah yang akan kami pakai. Bobot tiap baris boleh berbeda — bisnis yang hanya menjual hotel tidak terlalu peduli soal penerbitan tiket — dan sebaiknya Anda memperdebatkannya dulu sebelum mengadopsinya.

PorosYang ditanyakan checklistYang sebenarnya perlu dicari tahuSeperti apa jawaban yang lemah
CakupanBerapa maskapai dan hotel?Berapa yang bisa dicari, di-booking DAN diterbitkan tiketnya atau dikonfirmasi lewat API ini, untuk pasar AndaSatu angka besar tanpa rincian
KedalamanAda endpoint pembatalan?Tindakan pasca-booking mana yang otomatis per sumber konten: void, refund, reissue, koreksi nama, ancillary"Tim operasional kami yang menangani"
Integritas hargaApakah harganya real-time?Seberapa sering harga saat booking berbeda dari harga saat pencarian, dan bagaimana API memberi tahu Anda"Harga selalu live"
Semantik errorApakah error terdokumentasi?Apakah error memberi tahu status booking, bukan sekadar bahwa ada yang gagalSatu kode error generik untuk semua kegagalan
Idempotensi—Apakah panggilan booking yang diulang bisa membuat booking keduaDiam, lalu "kami belum pernah melihat itu"
Supplier of record—Kontrak siapa, nomor IATA siapa, BSP siapa yang dilalui tiket"Kami bekerja dengan semua GDS besar"
Akses dan dukunganAda sandbox?Siapa yang menjawab saat PNR live macet, dan seberapa cepatFormulir tiket tanpa kontak bernama

Dua baris di atas sama sekali tidak punya pertanyaan di checklist. Itu bukan kebetulan: justru baris inilah yang paling mahal ketika salah, dan yang paling kecil kemungkinannya diungkap sendiri oleh presentasi vendor.

Cakupan bukan kedalaman

Daftar maskapai adalah slide paling menyesatkan di presentasi mana pun. Daftar beberapa ratus maskapai bisa berarti beberapa hal berbeda, dan hanya satu yang Anda inginkan.

Sebagian maskapai itu datang lewat GDS dan bisa di-booking serta di-issue dari awal sampai akhir. Sebagian lewat koneksi NDC, di mana pencarian mungkin lancar tetapi layanan setelah booking — perubahan, refund sebagian, tambah bagasi — mungkin masih manual untuk maskapai tersebut. Sebagian lagi maskapai berbiaya rendah yang kontennya diagregasi dari reseller lain; Anda bisa menampilkannya, kadang bisa mem-booking-nya, lalu tiketnya datang lewat jalur yang tidak Anda kendalikan, dengan waktu yang tidak bisa Anda janjikan kepada pelanggan. Dan ada yang masuk daftar hanya karena sebuah tarif pernah muncul di respons pencarian.

Maskapai yang bisa Anda tampilkan tetapi tidak bisa Anda terbitkan tiketnya bukan cakupan. Bagi produk ritel, itu lebih buruk daripada tidak ada sama sekali, karena pelanggan memilihnya, membayar, lalu menunggu.

Hotel punya pola yang sama dengan istilah berbeda. Jumlah properti mencakup properti yang sudah dipetakan vendor dan yang belum; tarif statis yang di-cache minggu lalu bersebelahan dengan ketersediaan live; kamar allotment dengan release period bersebelahan dengan inventaris free-sale. Mintalah angka yang benar-benar bisa di-booking secara live di kota-kota yang Anda jual, dan tanyakan bagaimana duplikat antar-supplier mereka sendiri digabungkan — hotel yang sama muncul tiga kali dengan tiga harga adalah tiket komplain yang tinggal menunggu waktu.

Tes praktisnya sempit. Tuliskan dua puluh rute dan dua puluh kota hotel yang membentuk sebagian besar volume Anda, lalu minta vendor menunjukkan semuanya berjalan dari awal sampai akhir di sandbox: cari, harga, booking, issue atau konfirmasi, batalkan. Vendor yang punya kedalaman akan melakukannya tanpa banyak cerita. Vendor yang hanya punya slide akan mulai membahas slide-nya.

Apa yang diuji saat trial: jalur error, bukan jalur mulus

Setiap sandbox berhasil mem-booking tiket ekonomi sekali jalan di rute yang sepi. Memang untuk itulah sandbox dibuat. Trafik produksi Anda akan menghabiskan sebagian besar hidupnya di jalur-jalur lain, dan trial adalah satu-satunya momen murah untuk melihatnya.

Gunakan trial untuk menjalankan daftar ini, dan catat apa yang dikembalikan API di samping apa yang sebenarnya terjadi sesudahnya:

  • Harga berubah antara pencarian dan booking. Apakah panggilan booking gagal, berhasil dengan harga baru, atau mengembalikan respons khusus yang meminta konfirmasi? Bisakah UI Anda membedakannya tanpa mem-parsing teks pesan?
  • Penawaran kedaluwarsa. Cari, tunggu lebih lama dari masa berlaku penawaran vendor, lalu booking. Apakah kedaluwarsa itu error tersendiri, atau sama dengan error "supplier down"?
  • Habis saat booking. Inventaris yang hilang antara harga dan booking. Dalam status apa booking itu, dan apakah otorisasi pembayaran dilepas?
  • Retry setelah timeout. Kirim permintaan booking, putuskan koneksi sebelum respons datang, lalu kirim lagi. Sekarang Anda punya satu PNR atau dua? Tes yang satu ini memberi tahu lebih banyak tentang vendor daripada seluruh sisa trial digabung.
  • Booking terbentuk, penerbitan tiket gagal. Bisakah API melaporkan PNR yang ada tetapi belum ter-issue, dan apakah ia memberi tahu batas waktu penerbitan tiket?
  • Kegagalan sebagian. Permintaan hotel multi-kamar di mana satu kamar terkonfirmasi dan satu tidak. Pulang-pergi di mana penerbangan berangkat dan pulang datang dari sumber berbeda.
  • Pembatalan di luar jendela gratis. Apakah penalti disebutkan sebelum Anda konfirmasi, atau baru ketahuan di invoice?
  • Supplier down. Tanyakan ke vendor cara menyimulasikannya. Kalau tidak bisa, tanyakan bagaimana klien mereka mengetahui perilakunya.

Untuk setiap kasus Anda menilai dua hal. Pertama, apakah API jujur tentang status booking? Kedua, bisakah kode Anda bertindak berdasarkan kejujuran itu tanpa manusia membaca teks bebas? API yang gagal dengan jelas lebih mudah dihadapi daripada yang berhasil secara ambigu.

Kami menulis lebih rinci soal sisi penerbangan di apa yang tidak dibahas dokumentasi API pemesanan tiket pesawat, dan soal merancang klien untuk supplier hotel yang lambat di artikel ketersediaan hotel. Keduanya pendamping yang berguna untuk rencana trial.

Pertanyaan yang membongkar agregator tipis

Tidak ada yang salah dengan agregator. Sebagian besar konten travel sampai ke sebagian besar penjual melalui agregator. Risikonya ada pada yang tipis: lapisan yang menjual ulang API lapisan lain, menambahkan margin, dan tidak memiliki kontrak supplier maupun meja operasional. Saat ada yang rusak, jawabannya harus menempuh dua perusahaan ke hulu lalu kembali.

Lima pertanyaan memunculkannya dengan cepat:

  1. Siapa supplier of record untuk booking ini? Kontrak siapa dengan maskapai atau hotel yang menjadi dasarnya?
  2. Nomor IATA dan BSP siapa yang dilalui tiket? Jika jawabannya "milik partner", tanyakan siapa yang menerima ADM ketika aturan tarif dilanggar.
  3. Saat saya memanggil cancel, apa yang terjadi di sisi Anda? Panggilan otomatis ke supplier, atau antrean yang diambil orang?
  4. Bisakah saya melihat error dari hulu? Lapisan tipis cenderung meratakan semua kegagalan menjadi satu kode, karena ia tidak sepenuhnya memahami error yang diterimanya.
  5. Siapa yang saya hubungi soal booking live yang macet, dan siapa yang mereka hubungi? Hitung lompatannya.

Tidak satu pun jawaban ini otomatis menggugurkan. Nomor IATA milik partner bisa saja aman jika kontraknya jelas menyebut siapa yang menanggung debit memo. Yang penting, vendor menjawab dengan tepat dan cepat. Jawaban samar di sini adalah jawaban yang akan Anda terima nanti, di produksi, pada jam yang lebih buruk.

Berapa harga yang dibayar jika salah pilih

Integrasi adalah bagian yang murah. Bagian yang mahal datang belakangan dan tidak muncul di estimasi mana pun.

Bug booking ganda berarti pelanggan ditagih dua kali dan PNR yang harus Anda cari dan batalkan manual, mungkin setelah jendela void gratis tertutup. Booking yang berhasil di hulu sementara sisi Anda mencatat gagal berarti kursi tertahan, lalu batal otomatis, dan pelanggan yang yakin dirinya sudah ter-booking. Maskapai yang Anda tampilkan tetapi tidak bisa di-issue berarti refund, permintaan maaf, dan pelanggan yang tidak kembali. ADM untuk aturan tarif yang dilanggar oleh rute vendor jatuh ke pemilik tiket — pastikan sejak awal apakah itu Anda.

Lalu ada biaya berpindah. Setiap keanehan vendor yang Anda serap — status code yang berarti dua hal, field yang kadang berupa string — berakhir di model data Anda. Dua tahun kemudian, pilihan API bukan lagi integrasi yang bisa diganti dalam satu sprint; ia sudah menjadi bentuk tabel booking Anda. Itulah alasan sebenarnya untuk membandingkan dengan cermat sekarang.

Di mana posisi API kami dalam kerangka ini

Kami menyediakan API penerbangan dan hotel. Akses dimulai dari percakapan, bukan kunci swalayan, dan sebagian developer menganggapnya lambat; alasannya, percakapan itulah tempat pertanyaan-pertanyaan di atas diajukan dari dua arah — rute dan kota mana yang Anda butuhkan, konten mana yang benar-benar bisa Anda issue atau konfirmasi, dan siapa menangani apa setelah booking. Jika Anda sedang membandingkan, bawa daftar ini. Percakapan itu dimulai di halaman API travel.

Apa pun pilihan Anda, pilihlah berdasarkan log trial, bukan presentasi. Presentasi memberi tahu ingin menjadi apa sebuah vendor. Jalur error memberi tahu apa vendor itu sebenarnya.

Redaksi Tekravel

Meja teknologi perjalanan

Meja teknologi perjalanan Tekravel menulis untuk pelaku industri: pemilik agen, konsolidator, dan para pengembang yang mengintegrasikan mereka. Setiap artikel diperiksa pada platform yang dijelaskannya sebelum diterbitkan.