Pengujian sandbox API travel: yang tidak ditunjukkan sandbox

Integrasinya lolos semua yang bisa diujikan oleh pengujian sandbox API travel. Pencarian mengembalikan penerbangan, panggilan ketersediaan hotel mengembalikan kamar, panggilan booking selalu mengembalikan nomor konfirmasi, dan tim QA menyetujuinya pada hari Kamis. Selasa berikutnya, seorang pelanggan membayar hotel dengan satu harga dan supplier mengonfirmasinya dengan harga lain, sebuah booking penerbangan timeout dan tidak ada yang bisa memastikan apakah kursinya ditahan, dan seorang agen support menghabiskan satu sore untuk mencocokkan dua catatan yang menggambarkan perjalanan yang sama. Tidak satu pun dari itu adalah bug yang terlewat oleh test suite. Itu adalah skenario yang memang tidak pernah bisa dilihat oleh test suite. Sandbox itu wajib, tetapi jauh dari cukup, dan celah di antara keduanya adalah tempat sebagian besar insiden mahal dalam integrasi travel terjadi.
Ini adalah rencana pengujian untuk developer yang memegang integrasi tersebut: apa yang bisa dibuktikan sandbox, apa yang secara struktural tidak bisa, dan cara menutup selisihnya tanpa memesan kursi sungguhan dengan kartu perusahaan.
Mengapa pengujian sandbox API travel meloloskan kode yang rusak di produksi
Sandbox adalah janji tentang bentuk respons, bukan tentang perilakunya. Skemanya sama dengan produksi. Perilakunya hampir tidak pernah sama, dan alasannya bukan kesalahan siapa pun: lingkungan uji tidak mampu menjalankan inventaris live, jadi ia menyajikan sekumpulan tarif dan kamar tetap yang tidak pernah habis, tidak pernah berubah harga, dan tidak pernah berubah jadwal. Ia menjawab dengan cepat karena tidak ada orang lain yang memakainya. Ia jarang gagal di tengah jalan.
Produksi melakukan semua hal itu setiap hari. Inventaris dibagi dengan semua penjual lain; tarif di-cache oleh pihak di hulu dan menjadi basi; sistem supplier yang sedang dibebani menjawab lambat atau tidak menjawab sama sekali. Kode yang hanya pernah melihat sandbox pada dasarnya hanya diuji terhadap supplier yang sedang mengalami hari yang sempurna.
Karena itu, perlakukan sandbox sebagai satu dari tiga lapisan. Sandbox membuktikan request Anda tersusun dengan benar dan parser Anda memahami skemanya. Fixture hasil rekaman membuktikan kode Anda tahan terhadap respons yang benar-benar dikirim produksi. Sekumpulan kecil pengecekan live yang dipilih dengan sengaja membuktikan bahwa sambungannya tetap berfungsi setelah ada perubahan. Setiap lapisan menangkap apa yang tidak bisa ditangkap dua lapisan lainnya.
Skenario yang biasanya tidak bisa diberikan sandbox
Tuliskan skenario ini sebelum Anda menulis satu tes pun. Sandbox mungkin mensimulasikan satu atau dua di antaranya dengan nilai uji khusus; sebagian besar memang tidak tersedia.
| Skenario | Apa yang terjadi di produksi | Cara mengujinya |
|---|---|---|
| Harga berubah antara pencarian dan booking | Panggilan booking berhasil dengan total yang berbeda, atau gagal dengan error perubahan harga yang harus Anda tampilkan | Pasangan fixture: respons pencarian dan respons booking dengan total berbeda; pastikan traveler ditanya ulang, tidak pernah ditagih diam-diam |
| Habis terjual antara ketersediaan dan booking | Kamar atau kelas tarif yang ditawarkan sudah tidak ada saat Anda mencoba menahannya | Fixture berisi error habis terjual yang asli dari supplier; pastikan traveler kembali ke hasil pencarian, bukan ke halaman error |
| Timeout pada panggilan booking | Supplier mungkin sudah membuat booking, mungkin juga belum | Suntikkan timeout setelah request terkirim; pastikan Anda menanyakan status booking sebelum ada retry apa pun |
| Pengiriman ganda | Klik dua kali atau retry dari klien membuat dua booking | Kirim booking yang sama dua kali dengan idempotency key (kunci idempotensi) yang sama; pastikan hanya ada tepat satu booking |
| Perubahan jadwal setelah tiket terbit | Penerbangan yang Anda jual kini berangkat di jam lain, atau dengan nomor penerbangan lain | Fixture itinerary yang sudah diubah; pastikan perubahan sampai ke pihak yang memegang pelanggan |
| Sukses sebagian pada booking multi-item | Penerbangan terkonfirmasi, hotelnya tidak | Fixture campuran; pastikan sistem mencatat persis apa yang terkonfirmasi dan memberi tahu manusia |
| Throttling saat beban tinggi | Respons rate-limit, lalu jawaban yang lambat | Putar ulang respons throttling hasil rekaman; pastikan ada backoff, dan pencarian menurun kualitasnya alih-alih error |
Anda mungkin tidak setuju dengan kolom terakhir untuk stack Anda sendiri. Tidak masalah. Yang penting, setiap baris punya pemilik dan assertion, karena masing-masing pada akhirnya akan menimpa Anda.
Bangun fixture dari respons asli, bukan rekaan
Kebiasaan paling berguna dalam integrasi travel adalah menyimpan respons yang pernah mengejutkan Anda. Data mock yang ditulis tangan mencerminkan apa yang Anda kira dikirim supplier; respons hasil rekaman mencerminkan apa yang benar-benar dikirimnya, termasuk field yang kosong padahal dokumentasi bilang tidak pernah kosong, harga dalam mata uang yang tidak Anda minta, dan error yang datang dengan status sukses.
Rutinitas yang terbukti jalan:
- Rekam di titik batas. Catat body request dan respons mentah untuk panggilan ke supplier di lingkungan non-produksi, dan di produksi untuk sebagian sampel trafik jika aturan privasi Anda mengizinkan.
- Bersihkan sebelum disimpan. Nama penumpang, nomor paspor, email, nomor telepon, dan referensi pembayaran harus dihapus sebelum fixture masuk ke repositori. Ganti dengan nilai yang jelas-jelas palsu agar tidak ada yang mengira fixture itu booking sungguhan.
- Beri nama fixture berdasarkan perilaku.
hotel-book-price-increased.jsonmemberi tahu developer berikutnya mengapa file itu ada;response-17.jsontidak. - Simpan yang jelek selamanya. Respons rusak yang pernah menjatuhkan pencarian pada suatu hari Minggu adalah file paling berharga yang Anda miliki. Tempatnya di tes yang berjalan pada setiap commit.
Setelah itu, tulis contract test terhadap fixture tersebut: parser Anda, pemetaan ke model internal, dan klasifikasi error. Jika supplier mengganti nama sebuah field dan contract test gagal, Anda mengetahuinya di CI, bukan dari pelanggan. Sisi klasifikasi dibahas lebih dalam di artikel kami tentang penanganan error API booking engine.
Menguji alur uang tanpa mengeluarkan uang
Di sinilah sandbox paling sedikit membantu, karena alur uang justru bagian di mana lingkungan uji paling berbeda dari yang asli. Penerbitan tiket sungguhan, penarikan dana kartu sungguhan, dan penagihan supplier sungguhan adalah hal yang paling perlu Anda kerjakan dengan benar sekaligus paling tidak mungkin Anda latih secara live.
Pecah masalahnya. Perhitungan harga adalah logika murni dan bisa diuji tuntas secara offline: ambil tarif hasil rekaman, terapkan aturan markup, konversi mata uang, dan pembulatan Anda, lalu pastikan total yang dilihat traveler benar. Lakukan untuk kasus-kasus yang merepotkan — tarif dalam satu mata uang yang dijual dalam mata uang lain, markup yang berupa persentase di satu produk dan nominal tetap di produk lain, tarif anak, langkah pembulatan yang berbeda antara tampilan dan penagihan. Total yang meleset beberapa satuan mata uang tetap saja salah, dan salahnya terjadi di setiap booking.
Separuh berikutnya adalah transisi status di sekitar pembayaran. Modelkan secara eksplisit — dikutip, ditahan, dibayar, dikonfirmasi, tiket terbit, dibatalkan, dikembalikan dananya — dan uji bahwa setiap transisi punya tepat satu penyebab. Tes yang menangkap bug paling mahal adalah tes yang memastikan pembayaran tidak bisa ditarik untuk booking yang belum dikonfirmasi supplier, dan bahwa booking terkonfirmasi tidak bisa ada tanpa catatan pembayaran.
Terakhir, buat test run mustahil menjangkau penerbitan tiket live. Bukan kecil kemungkinannya; mustahil. Pengecekan saat start-up yang menolak menjalankan suite ketika kredensial produksi termuat hanya butuh satu baris dan mencegah pagi terburuk yang bisa dialami tim integrasi.
Berapa biayanya jika Anda keliru
Skenario yang terlewat dalam integrasi travel jarang muncul sebagai error. Ia muncul sebagai booking yang tampak baik-baik saja. Tiket ganda yang tidak diminta siapa pun, yang harus di-void seseorang sebelum tenggat. Hotel yang dikonfirmasi dengan harga yang sekarang harus ditanggung agensi. Booking yang timeout lalu di-retry oleh sistem, sehingga supplier menahan dua kamar dan menagih keduanya. Untuk tiket pesawat yang dijual lewat agensi, ketidakcocokan antara yang diterbitkan dan yang dijual bisa kembali belakangan sebagai ADM, lama setelah margin dari penjualan itu terpakai.
Biaya-biaya itu jatuh ke bisnis yang menjual perjalanan, bukan ke developer yang menulis loop retry. Itulah inti argumen untuk mengujinya sebelum peluncuran, alih-alih mempelajarinya satu tiket support demi satu tiket support.
Apa yang perlu di-smoke-test setelah setiap perubahan di supplier
Supplier mengubah banyak hal: versi API baru, endpoint baru, kredensial yang dirotasi, pemetaan konten yang berbeda. Kode Anda sendiri mungkin sama sekali tidak berubah. Tetap jalankan daftar ini, di lingkungan yang terhubung ke supplier yang berubah:
- Satu pencarian untuk setiap produk yang Anda jual dari supplier itu, pada rute atau kota yang Anda tahu pasti mengembalikan hasil.
- Parse setiap hasil tanpa ada yang terbuang diam-diam; bandingkan jumlah hasil Anda dengan isi respons mentah.
- Hitung harga satu hasil dari awal sampai akhir dan bandingkan total yang ditampilkan dengan perhitungan Anda sendiri dari tarif mentah.
- Buat booking di lingkungan uji, baca kembali statusnya, dan bandingkan setiap field yang Anda simpan.
- Batalkan booking itu dan pastikan pembatalannya terlihat baik di catatan Anda maupun di sisi supplier.
- Putar ulang fixture jelek yang sudah Anda simpan melalui parser yang baru.
- Periksa bahwa timeout dan rate limit masih dipetakan ke perilaku yang sudah Anda tetapkan, karena versi baru bisa saja menjawabnya dengan cara berbeda. Jika waktu respons bergeser, artikel tentang latensi menjelaskan bagian mana yang menjadi tanggung jawab Anda untuk diperbaiki.
Cukup singkat untuk dijalankan setiap kali, dan memang itu tujuannya. Smoke test yang tidak pernah dijalankan karena butuh waktu seharian bukanlah smoke test.
Di mana posisi sandbox
Semua ini tidak membuat sandbox kurang berguna. Justru membuatnya jujur: tempat Anda mempelajari skema dan memastikan request sudah benar, sebelum fixture dan pengecekan live mengambil alih bagian yang tidak bisa dijangkaunya. Jika Anda sedang mengevaluasi API penerbangan dan hotel dari platform ini, akses dimulai dengan percakapan, bukan dengan key swalayan — bawa rencana pengujian ini ke percakapan itu dan tanyakan bagaimana setiap baris pada tabel di atas akan ditangani. Jawabannya akan memberi tahu Anda lebih banyak tentang sebuah API daripada dokumentasinya.