API tempahan penerbangan terbaik: nyatakan dahulu apa yang dibina

Tugasannya berbunyi: cari API tempahan penerbangan terbaik. Anda membuka tiga halaman perbandingan, dan ketiga-tiganya menyusun segelintir nama yang sama dalam tiga susunan berbeza, masing-masing dengan jadual ciri penuh tanda semak. Pada halaman ketiga anda perasan apa yang tidak ditanya oleh mana-mana satu: apa yang berlaku kepada pelanggan selepas hasil carian kembali.
Soalan yang tertinggal itu ialah seluruh jawapannya. API tempahan penerbangan terbaik untuk halaman yang menghantar pelawat ke laman syarikat penerbangan ialah pilihan yang lemah untuk laman yang menerima tempahan dan kad. Kedua-duanya juga bukan yang sesuai untuk alat dalaman yang digunakan staf agensi sepanjang hari. Carian, harga dan tempahan kelihatan sama dalam setiap dokumentasi. Perbezaannya terletak di bawahnya, dan perbezaan mana yang menjejaskan anda bergantung sepenuhnya pada produk.
Tiga produk yang semuanya dipanggil "laman tempahan penerbangan"
Yang pertama ialah halaman perbandingan atau inspirasi: paparkan tambang, pautkan keluar, jangan sentuh tiket. Di sini API hampir hanya carian. Yang anda pedulikan ialah betapa luas dan segarnya hasil, serta sama ada harga yang dipaparkan cukup hampir dengan harga yang dilihat pelawat apabila tiba di sana. Tiada apa dalam sistem anda yang perlu membatalkan, membayar balik atau menerbitkan semula, jadi kekuatan pembekal dalam hal itu tidak berguna kepada anda.
Yang kedua menjual. Pelawat membayar anda, anda menempah, dan sejak saat itu anda memiliki kitaran hayat tempahan: sahkan harga sebelum mengenakan caj, uruskan syarikat penerbangan yang lambat menjawab, void pada hari yang sama, refund kemudian, terbitkan semula apabila pelanggan menukar tarikh. Untuk produk ini, endpoint carian ialah bahagian yang mudah. Sifat yang menentukan pilihan datang selepasnya.
Yang ketiga ialah alat agensi itu sendiri, digunakan staf yang sudah mempunyai hubungan dengan pembekal. Carian mentah bukan perkaranya. Yang penting ialah kandungan yang dirundingkan oleh agensi sendiri muncul, sub-ejen boleh dihadkan dengan had kredit, markup dikenakan sebelum sesiapa melihat harga, dan laporan tersedia pada hujung bulan. API yang cemerlang untuk produk kedua masih boleh menjadi asas yang salah di sini.
Wajar dikatakan terus terang: API yang sama tidak boleh menjadi yang terbaik untuk ketiga-tiganya. Jika sesuatu senarai kedudukan mendakwa sebaliknya, ia belum pernah berdepan dengan produk kedua.
Sifat yang wajar dibandingkan, dan siapa yang bergantung padanya
Kecilkan jadual ciri kepada baris yang benar-benar boleh dipertikaikan oleh seorang pembangun. Setiap produk bergantung pada subset yang berbeza, dan selebihnya boleh anda abaikan.
| Sifat | Halaman pengalihan | Menjual dan menerima bayaran | Alat untuk staf agensi |
|---|---|---|---|
| Sejauh mana harga yang dipaparkan boleh lapuk sebelum disahkan | Sedikit penting | Penentu: anda mengenakan caj berdasarkannya | Penting, staf membuat sebut harga dengannya |
| Apa yang dikembalikan tempahan apabila syarikat penerbangan lambat | Tidak berkaitan | Penentu | Penting |
| Siapa boleh void dan refund, dan bagaimana ia diminta | Tidak berkaitan | Penentu | Penentu |
| Bagaimana tempahan yang hasilnya tidak diketahui diselesaikan | Tidak berkaitan | Penentu: kad mungkin sudah dicaj | Penting |
| Sama ada kandungan dan peraturan kredit agensi sendiri terpakai | Tidak berkaitan | Kadangkala | Penentu |
| Sejauh mana tingkah laku ujian berbeza daripada live | Rendah | Tinggi | Tinggi |
Baca lajur anda dan abaikan yang lain. Kesilapan yang memakan wang ialah membaca lajur pengalihan kerana ia paling mudah dinilai, lalu membina produk kedua.
Harga yang anda paparkan belum lagi harga yang anda caj
Ambil produk kedua dan ikuti satu tambang melaluinya. Carian memulangkan harga. Pelawat melihatnya, berfikir, membuka tab lain, kemudian kembali. Beberapa ketika kemudian dia menekan butang. Antara carian dan butang itu, tambang tersebut tersimpan dalam sistem anda, dan satu-satunya soalan jujur tentang mana-mana API ialah apa yang akan dikatakannya apabila anda bertanya semula pada saat itu.
Pembekal boleh memberi tiga jawapan. Ia boleh mengesahkan harga yang anda paparkan. Ia boleh memulangkan harga baharu, dan kod anda perlu memutuskan sama ada mengecaj perbezaannya, bertanya kepada pelanggan atau berhenti. Atau ia boleh mengatakan tambang itu sudah tiada. Laman yang hanya merancang untuk jawapan pertama akan berfungsi dalam setiap demo dan gagal pada minggu-minggu berikutnya, dan gagalnya dengan cara yang memakan wang, bukan memaparkan ralat.
Jadi soalan reka bentuknya bukan sama ada API mempunyai langkah pengesahan harga. Hampir semuanya ada. Soalannya ialah rupa respons bagi ketiga-tiga hasil, dan sama ada kod anda boleh membezakannya tanpa meneka. Minta contoh bagi setiap satu. Pembekal yang boleh menunjukkan yang kedua dan ketiga dalam dokumentasinya telah memikirkan produk anda. Yang hanya menunjukkan yang pertama baru memikirkan demonya.
Ujian satu petang yang tidak dapat diberikan oleh mana-mana jadual
Apa pun senarai pendeknya, jalankan ujian ringkas yang sama pada setiap nama, dan jalankannya dengan kegagalan yang disengajakan. Tempah sesuatu dan lihat apa yang disimpan objek tempahan selepas tiket diterbitkan. Semak harga jadual perjalanan yang sama dua kali, berselang beberapa minit, dan lihat bagaimana jawapan kedua berkait dengan yang pertama. Batalkan, kemudian minta bayaran balik, dan catat siapa yang perlu bertindak. Selepas itu kemukakan dua soalan bertulis kepada pembekal: apa yang dipulangkan sistem anda apabila syarikat penerbangan tamat masa di tengah-tengah tempahan, dan bagaimana saya tahu apa yang sebenarnya berlaku.
Jawapan bertulis lebih bernilai daripada demo. Pembekal yang mempunyai prosedur jelas untuk hasil yang tidak diketahui pernah berdepan masalah itu. Pembekal yang menjawab dengan nama ciri belum.
Tentang cara menyusun pelan ujian itu sendiri, pelan sandbox menghuraikan apa yang tidak akan ditunjukkan oleh sandbox. Dan jika anda menimbang pembekal berdasarkan apa yang berada di belakang API, bukan API itu sendiri, itu soalan berasingan dengan artikelnya sendiri; artikel ini kekal pada produk.
Harga yang anda bayar jika memilih berdasarkan senarai endpoint
Kegagalannya senyap. Sebuah laman lambat mengesahkan harga, maka perbezaan antara tambang yang dipaparkan dengan tambang sebenar keluar daripada margin anda, satu tempahan demi satu tempahan. Sebuah tempahan tersangkut dalam keadaan tidak diketahui sedangkan kad pelanggan sudah dicaj, dan seseorang perlu menyelesaikannya secara manual, biasanya melalui e-mel, biasanya pada hujung minggu. Alat yang dibina atas kandungan carian semata-mata rupa-rupanya tidak boleh digunakan staf untuk menerbitkan tiket, dan projek itu dibina semula di sekitar kandungan lain.
Tiada satu pun daripada ini kelihatan dalam jadual tanda semak. Semuanya kelihatan dalam lajur pertama jadual di atas, sebelum sebaris kod pun ditulis.
Kedudukan kami sendiri lebih sempit daripada apa yang dibenarkan oleh senarai kedudukan. Tekravel menyediakan API penerbangan dan hotel, akses bermula dengan perbualan, bukan kunci layan diri, perkhidmatan dihidupkan bagi setiap tenant, dan kandungan pembekal sampai kepada tenant melalui kumpulan pembekal. Itu sesuai untuk produk kedua dan ketiga. Jika anda membina yang pertama, mungkin anda langsung tidak memerlukan kami. Jika anda membina salah satu daripada dua yang lain, halaman API ialah tempat untuk memulakan perbualan.