Langkau ke kandungan
Blog

Ujian sandbox API pelancongan: apa yang sandbox sembunyikan

Sidang Pengarang Tekravel
Ditulis dengan bantuan AI

Integrasi itu lulus setiap ujian yang dapat dilemparkan oleh ujian sandbox API pelancongan. Carian memulangkan penerbangan, panggilan ketersediaan hotel kembali dengan bilik, panggilan tempahan memulangkan nombor pengesahan setiap kali, dan pasukan QA meluluskannya pada hari Khamis. Selasa berikutnya, seorang pelanggan membayar hotel pada satu harga dan pembekal mengesahkannya pada harga lain, satu tempahan penerbangan tamat masa dan tiada siapa dapat memastikan sama ada tempat duduk telah ditahan, dan seorang ejen sokongan menghabiskan sepanjang petang menyelaraskan dua rekod yang menggambarkan perjalanan yang sama. Tiada satu pun daripadanya pepijat yang terlepas oleh suite ujian. Semuanya senario yang suite ujian itu memang tidak pernah berupaya melihat. Sandbox itu perlu, tetapi jauh daripada mencukupi, dan jurang antara kedua-duanya itulah tempat kebanyakan insiden mahal dalam integrasi pelancongan berlaku.

Ini ialah pelan ujian untuk pembangun yang memiliki integrasi tersebut: apa yang dapat dibuktikan oleh sandbox, apa yang secara strukturnya tidak mampu dibuktikan, dan cara menampung perbezaan itu tanpa menempah tempat duduk sebenar menggunakan kad syarikat.

Mengapa ujian sandbox API pelancongan meluluskan kod yang rosak di produksi

Sandbox ialah janji tentang bentuk respons, bukan tentang kelakuannya. Skemanya sepadan dengan produksi. Kelakuannya hampir tidak pernah sepadan, atas sebab yang bukan salah sesiapa: persekitaran ujian tidak mampu menjalankan inventori langsung, jadi ia menyajikan set tambang dan bilik yang tetap, yang tidak pernah habis dijual, tidak pernah berubah harga dan tidak pernah berubah jadual. Ia menjawab dengan pantas kerana tiada orang lain yang menggunakannya. Ia jarang gagal di tengah jalan.

Produksi melakukan semua perkara itu setiap hari. Inventori dikongsi dengan setiap penjual lain; tambang disimpan dalam cache oleh pihak lain di hulu dan menjadi lapuk; sistem pembekal yang dibebani menjawab dengan perlahan atau langsung tidak menjawab. Kod yang hanya pernah berdepan dengan sandbox, pada hakikatnya, hanya diuji terhadap pembekal yang sedang mengalami hari yang sempurna.

Oleh itu, anggap sandbox sebagai satu daripada tiga lapisan. Ia membuktikan permintaan anda dibentuk dengan betul dan penghurai anda memahami skema. Fixture yang dirakam membuktikan kod anda bertahan terhadap respons yang benar-benar dihantar oleh produksi. Satu set kecil semakan langsung yang disengajakan membuktikan pendawaian berfungsi selepas sesuatu berubah. Setiap lapisan menangkap apa yang tidak dapat ditangkap oleh dua lapisan yang lain.

Senario yang biasanya tidak dapat diberikan oleh sandbox

Tuliskan senario ini sebelum anda menulis walau satu ujian. Sandbox mungkin menyimulasikan satu atau dua daripadanya dengan nilai ujian istimewa; kebanyakannya memang tiada langsung.

SenarioApa yang berlaku di produksiCara menampungnya
Harga berubah antara carian dan tempahanPanggilan tempahan berjaya dengan jumlah yang berbeza, atau gagal dengan ralat perubahan harga yang mesti anda paparkanPasangan fixture: respons carian dan respons tempahan dengan jumlah berbeza; pastikan pengembara ditanya semula, bukan dicaj secara senyap
Habis dijual antara ketersediaan dan tempahanBilik atau kelas tambang yang ditawarkan sudah tiada apabila anda cuba menahannyaFixture ralat habis dijual sebenar daripada pembekal; pastikan pengembara dikembalikan ke senarai hasil, bukan ke halaman ralat
Tamat masa pada panggilan tempahanPembekal mungkin telah mencipta tempahan, mungkin juga tidakSuntik tamat masa selepas permintaan dihantar; pastikan anda menyemak status tempahan sebelum apa-apa cubaan semula
Penghantaran bergandaKlik dua kali atau cubaan semula oleh klien mencipta dua tempahanHantar tempahan yang sama dua kali dengan idempotency key yang sama; pastikan hanya satu tempahan wujud
Perubahan jadual selepas tiket dikeluarkanPenerbangan yang anda jual kini berlepas pada waktu lain, atau dengan nombor penerbangan lainFixture itinerari yang diubah suai; pastikan perubahan itu sampai kepada pihak yang memiliki pelanggan
Kejayaan separa pada tempahan berbilang itemPenerbangan disahkan tetapi hotel tidakFixture bercampur; pastikan sistem merekodkan dengan tepat apa yang disahkan dan memaklumkan manusia
Pendikitan ketika beban tinggiRespons had kadar, kemudian jawapan yang perlahanMain semula respons pendikitan yang dirakam; pastikan ada backoff, dan carian merosot secara beransur, bukan menjadi ralat

Anda mungkin tidak bersetuju dengan lajur terakhir untuk stack anda sendiri. Tidak mengapa. Yang penting, setiap baris mempunyai pemilik dan penegasan, kerana setiap satu akhirnya akan berlaku kepada anda.

Bina fixture daripada respons sebenar, bukan rekaan

Tabiat paling berguna dalam integrasi pelancongan ialah menyimpan respons yang pernah mengejutkan anda. Data mock yang ditulis tangan mencerminkan apa yang anda sangka dihantar oleh pembekal; respons yang dirakam mencerminkan apa yang benar-benar dihantar, termasuk medan yang kosong walaupun dokumentasi menyatakan ia tidak pernah kosong, harga dalam mata wang yang anda tidak minta, dan ralat yang tiba bersama status berjaya.

Rutin yang berkesan:

  • Rakam di sempadan. Log badan permintaan dan respons mentah bagi panggilan pembekal dalam persekitaran bukan produksi, dan di produksi untuk sebahagian trafik yang disampel jika peraturan privasi anda membenarkannya.
  • Bersihkan sebelum menyimpan. Nama penumpang, nombor pasport, e-mel, nombor telefon dan rujukan pembayaran mesti dibuang sebelum fixture masuk ke repositori. Gantikan dengan nilai yang jelas palsu supaya tiada siapa menyangka fixture itu tempahan sebenar.
  • Namakan fixture mengikut kelakuan. hotel-book-price-increased.json memberitahu pembangun seterusnya mengapa fail itu wujud; response-17.json tidak.
  • Simpan yang hodoh selama-lamanya. Respons cacat yang melumpuhkan carian pada suatu hari Ahad ialah fail paling berharga yang anda miliki. Tempatnya dalam ujian yang berjalan pada setiap commit.

Kemudian tulis ujian kontrak terhadap fixture tersebut: penghurai anda, pemetaan anda ke model dalaman, dan pengelasan ralat anda. Jika pembekal menukar nama sesuatu medan dan ujian kontrak gagal, anda mengetahuinya dalam CI, bukan daripada pelanggan. Bahagian pengelasan dihuraikan dengan lebih mendalam dalam artikel kami tentang pengendalian ralat API enjin tempahan.

Menguji laluan wang tanpa membelanjakan wang

Di sinilah sandbox paling kurang membantu, kerana laluan wang ialah tempat persekitaran ujian paling berbeza daripada yang sebenar. Pengeluaran tiket sebenar, caj kad sebenar dan invois pembekal sebenar ialah perkara yang paling perlu anda betulkan, tetapi paling sukar dilatih secara langsung.

Pecahkan masalah itu. Matematik harga ialah logik tulen dan boleh diuji secara menyeluruh di luar talian: ambil tambang yang dirakam, gunakan peraturan markup, penukaran mata wang dan pembundaran anda, kemudian pastikan jumlah yang dilihat oleh pengembara. Lakukannya untuk kes yang janggal — tambang dalam satu mata wang yang dijual dalam mata wang lain, markup yang berbentuk peratusan pada satu produk dan amaun tetap pada produk lain, tambang kanak-kanak, langkah pembundaran yang berbeza antara paparan dan caj. Jumlah yang salah beberapa unit mata wang tetap salah, dan ia salah pada setiap tempahan.

Peralihan keadaan di sekitar pembayaran ialah separuh lagi. Modelkan keadaan itu secara eksplisit — disebut harga, ditahan, dibayar, disahkan, tiket dikeluarkan, dibatalkan, dipulangkan — dan uji bahawa setiap peralihan mempunyai tepat satu punca. Ujian yang menangkap pepijat paling mahal ialah ujian yang menegaskan bahawa pembayaran tidak boleh dicaj untuk tempahan yang belum disahkan oleh pembekal, dan bahawa tempahan yang disahkan tidak boleh wujud tanpa rekod pembayaran.

Akhir sekali, jadikan mustahil bagi sesuatu larian ujian untuk sampai ke pengeluaran tiket langsung. Bukan sekadar tidak mungkin; mustahil. Semakan semasa permulaan yang enggan menjalankan suite apabila kelayakan produksi dimuatkan hanya memerlukan satu baris kod, dan ia mengelakkan pagi paling buruk yang boleh dialami oleh pasukan integrasi.

Apa kosnya jika anda tersilap

Senario yang terlepas dalam integrasi pelancongan jarang muncul sebagai ralat. Ia muncul sebagai tempahan yang nampak elok. Tiket pendua yang tiada siapa minta, yang perlu dibatalkan oleh seseorang sebelum tarikh akhir. Hotel yang disahkan pada harga yang kini terpaksa ditanggung oleh agensi. Tempahan yang tamat masa lalu dicuba semula oleh sistem, sehingga pembekal menahan dua bilik dan menginvois kedua-duanya. Bagi tiket penerbangan yang dijual melalui agensi, ketidakpadanan antara apa yang dikeluarkan dan apa yang dijual boleh kembali kemudian sebagai ADM, lama selepas margin jualan itu habis dibelanjakan.

Kos itu ditanggung oleh perniagaan yang menjual perjalanan tersebut, bukan oleh pembangun yang menulis gelung cubaan semula. Itulah keseluruhan hujah untuk mengujinya sebelum pelancaran, dan bukannya mempelajarinya satu tiket sokongan demi satu tiket sokongan.

Apa yang perlu diuji asap selepas setiap perubahan pembekal

Pembekal sentiasa mengubah sesuatu: versi API baharu, endpoint baharu, kelayakan yang diputar, pemetaan kandungan yang berbeza. Kod anda sendiri mungkin langsung tidak berubah. Jalankan senarai ini juga, dalam persekitaran yang berhubung dengan pembekal yang berubah itu:

  1. Satu carian bagi setiap produk yang anda jual daripada pembekal itu, pada laluan atau bandar yang anda tahu memulangkan hasil.
  2. Hurai setiap hasil tanpa menggugurkan mana-mana secara senyap; bandingkan kiraan anda dengan kandungan respons mentah.
  3. Tetapkan harga satu hasil dari awal hingga akhir dan bandingkan jumlah yang dipaparkan dengan pengiraan anda sendiri daripada tambang mentah.
  4. Buat satu tempahan dalam persekitaran ujian, baca semula statusnya dan bandingkan setiap medan yang anda simpan.
  5. Batalkannya dan sahkan pembatalan itu kelihatan dalam rekod anda dan juga di pihak pembekal.
  6. Main semula fixture hodoh yang anda simpan melalui penghurai baharu.
  7. Semak bahawa tamat masa dan had kadar masih dipetakan kepada kelakuan yang telah anda putuskan, kerana versi baharu mungkin menjawabnya secara berbeza. Jika masa respons berubah, artikel tentang latensi menerangkan bahagian mana yang menjadi tanggungjawab anda untuk dibaiki.

Cukup ringkas untuk dijalankan setiap kali, dan itulah tujuannya. Ujian asap yang tiada siapa jalankan kerana ia mengambil masa sehari bukanlah ujian asap.

Di mana tempat sandbox

Semua ini tidak menjadikan sandbox kurang berguna. Ia menjadikannya jujur: tempat anda mempelajari skema dan mengesahkan permintaan anda betul, sebelum fixture dan semakan langsung mengambil alih bahagian yang tidak dapat dicapainya. Jika anda sedang menilai API penerbangan dan hotel platform ini, akses bermula dengan perbualan, bukan kunci layan diri — bawa pelan ujian ini ke perbualan tersebut dan tanya bagaimana setiap baris dalam jadual di atas akan ditampung. Jawapannya akan memberitahu anda lebih banyak tentang sesebuah API berbanding dokumentasinya.

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.