Sebelum menyewa perusahaan integrasi API di Dubai

Tiga penawaran ada di meja. Setiap perusahaan integrasi punya portofolio situs travel, setiap perusahaan berjanji akan "menghubungkan API penerbangan ke situs Anda", dan yang termurah bisa mulai minggu depan. Anda menjalankan agen di Deira dengan enam staf dan pelanggan korporat yang stabil, dan Anda lelah menyalin tarif dari extranet pemasok ke pesan WhatsApp. Memilih perusahaan integrasi API di Dubai yang paling tampak kompeten terasa seperti seluruh keputusan.
Padahal itu baru sekitar sepertiganya. Keputusan yang menentukan apakah situs itu laku tidak ada di ketiga penawaran, karena keputusan itu bukan kode. Keputusan itu menyangkut dengan siapa pemasok berkontrak, atas nama siapa tiket diterbitkan, di mana uang berada antara pemesanan dan penerbitan, dan siapa yang mengurus refund ketika pelanggan membatalkan. Integrator bisa menyambungkan semuanya. Integrator tidak bisa menjadi salah satunya untuk Anda.
Tulisan ini untuk pemilik yang akan menandatangani dokumen lingkup kerja, bukan untuk developer yang akan membacanya.
Apa yang bisa diberikan perusahaan integrasi API di Dubai, dan apa yang tidak
Perusahaan integrasi menulis kode di antara API pemasok dan situs Anda: formulir pencarian, panggilan yang menanyakan ketersediaan, pengecekan harga sebelum pembayaran, permintaan pemesanan, layar yang menampilkan hasil, dan jika lingkupnya menyebutkan, panggilan untuk pembatalan dan refund. Yang bagus juga mengurus bagian membosankan yang penting: percobaan ulang ketika pemasok tidak merespons, log yang memungkinkan pemesanan gagal dilacak, lingkungan uji yang berperilaku seperti produksi.
Yang tidak bisa diserahkan adalah semua yang ada di seberang kode itu. Sebelum satu baris ditulis, agen membutuhkan:
- akun pemasok atas nama agen sendiri, dengan akses API yang diberikan ke akun itu;
- kewenangan menerbitkan tiket, baik akreditasi sendiri maupun konsolidator yang menerbitkan atas nama agen;
- pengaturan dana dengan pemasok itu: deposit, batas kredit, atau pembayaran kartu yang diteruskan;
- seseorang yang mengerjakan urusan setelah tiket terbit (void, refund, reissue, perubahan jadwal), lewat API atau, jika tidak bisa, secara manual.
Integrator yang menawarkan untuk "membereskan sisi pemasok" biasanya menawarkan untuk meminjamkan miliknya. Sebagai jalan pintas untuk prototipe, itu bisa masuk akal. Untuk bisnis, artinya situs pemesanan Anda berjalan di atas hubungan yang bukan milik Anda dan tidak bisa Anda bawa pergi.
Brief: tujuh baris untuk dokumen lingkup kerja
Sebagian besar sengketa dengan integrator berawal dari satu kalimat yang tidak pernah ditulis. Masukkan poin-poin ini ke dokumen yang Anda tandatangani, dengan kata-kata sederhana, dan minta setiap jawabannya secara tertulis.
- Atas nama siapa akun pemasok dan kunci API. Atas nama agen. Kunci adalah kredensial: disimpan di pengelola kata sandi Anda, dan integrator diberi akses, bukan kepemilikan.
- Siapa yang meng-hosting situs dan siapa pemegang domain. Domain terdaftar atas nama agen. Akun hosting milik agen, atau kontrak menyebut persis bagaimana akun itu dialihkan.
- Operasi apa saja yang termasuk lingkup. Sebutkan satu per satu: pencarian, harga, pemesanan, penerbitan tiket, pembatalan, refund, perubahan. Apa pun yang tidak ada di daftar tetap menjadi email ke meja pemasok selama situs itu hidup. Refund dan perubahan paling sering terlewat, karena demo tidak pernah menunjukkannya.
- Siapa yang memelihara ketika pemasok mengubah API-nya. Pemasok menghentikan versi dan mengganti nama field. Proyek harga tetap tanpa klausul pemeliharaan berakhir pada hari versi pertama berubah.
- Apa arti serah terima. Kode sumber di repositori milik agen, semua kredensial, dan dokumen yang memungkinkan developer lain melanjutkan pekerjaan. "Nanti kami kirim zip" bukan serah terima.
- Bagaimana go-live dibuktikan. Pemesanan uji dari pencarian sampai tiket di lingkungan uji pemasok, termasuk pembatalan, sebelum siapa pun menagih kartu pelanggan sungguhan.
- Apa yang terjadi pada data pelanggan. Nama penumpang, data paspor, dan referensi pembayaran: di mana disimpan, siapa yang bisa membacanya, dan bagaimana dihapus.
Tak satu pun butuh latar belakang teknis untuk ditulis. Masing-masing lebih murah disepakati sebelum pembangunan daripada dinegosiasikan sesudahnya.
Tiga cara membawa konten pemasok ke situs Anda
Menyewa integrator untuk API pemasok adalah satu jalan. Layak dilihat berdampingan dengan dua jalan lain sebelum sebuah penawaran memutuskan untuk Anda.
| Jalan | Siapa pemegang hubungan dengan pemasok | Siapa yang menjaga koneksi tetap jalan | Apa yang masih harus dibangun agen | Biaya untuk pindah |
|---|---|---|---|---|
| Integrator menghubungkan situs Anda ke API pemasok | Agen, jika brief menyebutkannya; jika tidak, sering kali integrator | Integrator di bawah kontrak pemeliharaan, atau tidak ada | Admin, markup, data pelanggan, laporan, pembayaran, layar layanan purnajual | Kecil jika kode dan kunci milik Anda; bangun ulang jika tidak |
| Integrator menghubungkan situs Anda ke API sebuah platform | Platform memegang kontrak pemasok; agen memegang akunnya di platform | Platform di sisi pemasok; integrator di sisi Anda | Situs Anda, dan apa pun yang tidak dicakup API platform | Menulis ulang sisi Anda untuk API lain |
| Toko white-label yang sudah terhubung | Platform, melalui akun agen | Platform | Konten, keputusan harga, pelanggan sendiri | Memindahkan domain dan daftar pelanggan ke penyedia lain |
Baris yang layak diperdebatkan adalah yang pertama. Jalan ini memberi kendali paling besar dan membebani Anda paling banyak: setiap perubahan pemasok, setiap layanan baru, dan setiap operasi yang terlewat di pembangunan pertama menjadi proyek baru dengan penawaran baru.
Cara menambahkan pencarian ke situs yang sudah berjalan dibahas di menambahkan pencarian penerbangan ke situs yang sudah ada, dan API siapa yang berdiri di belakangnya di apa yang ada di balik penyedia API pemesanan tiket pesawat. Tulisan ini tentang kontrak di sekitar pekerjaannya.
Di mana posisi platform ini
Platform di balik blog ini menyediakan API penerbangan dan hotel. Akses dimulai dengan percakapan, bukan kunci swalayan, karena pertanyaan pertamanya adalah yang di atas (layanan apa, pasar mana, bagaimana uang bergerak), bukan endpoint mana yang dipanggil. Layanan diaktifkan per akun, dan setiap akun punya panel admin sendiri dengan pemesanan, pelanggan, markup, dan laporannya sendiri, sehingga kolom "masih harus dibangun" di baris kedua lebih pendek daripada kelihatannya.
Jika perusahaan integrasi akan membangun sisi Anda, lakukan percakapan itu sebelum menerima penawaran, supaya lingkup kerjanya menggambarkan API yang benar-benar akan disambungkan. Halaman API travel adalah tempat semuanya dimulai.
Harga dari brief yang lemah
Situs tayang. Pencarian berfungsi, harga tampak benar, dan pemesanan pertama datang pada Kamis malam. Tiketnya tidak bisa diterbitkan atas nama Anda, karena akun pemasok milik integrator dan menerbitkan di bawah pengaturan mereka. Kartu pelanggan sudah ditagih. Sekarang Anda memegang pemesanan yang tidak bisa diterbitkan maupun di-refund lewat situs Anda sendiri.
Atau situs itu berjalan setahun. Lalu pemasok pindah ke versi API baru, pemesanan berhenti, dan integrator, yang kontrak harga tetapnya berakhir saat serah terima, mengajukan penawaran proyek baru. Anda membayarnya, karena satu-satunya orang yang memahami kodenya adalah mereka yang mengajukan penawaran.
Atau integratornya sedang sibuk di tempat lain. Seorang pelanggan perlu nama di tiketnya dikoreksi, operasi perubahan tidak pernah masuk lingkup, dan dua staf Anda menghabiskan sore mengirim email ke meja pemasok. Persis pekerjaan yang seharusnya diambil alih oleh situs itu.
Masing-masing adalah satu kalimat yang hilang dari brief. Kodenya baik-baik saja setiap kali.