Sayohat API'ni sandboxda sinash: sandbox ko'rsatmaydigan narsalar

Integratsiya sayohat API'sini sandboxda sinash unga qarshi qo'ya oladigan hamma narsadan o'tdi. Qidiruv reyslarni qaytarardi, mehmonxona mavjudligi so'rovi bo'sh xonalar bilan kelardi, bron chaqiruvi har safar tasdiq raqamini berardi, QA esa payshanba kuni imzo chekdi. Keyingi seshanba kuni mijoz mehmonxona uchun bir narxda to'ladi, yetkazib beruvchi esa uni boshqa narxda tasdiqladi; reys broni timeout'ga tushdi va hech kim o'rindiq ushlab qolinganmi-yo'qmi ayta olmadi; qo'llab-quvvatlash xodimi esa tushdan keyingi vaqtini bitta safarni tasvirlaydigan ikki yozuvni solishtirishga sarfladi. Bularning hech biri test to'plami o'tkazib yuborgan bug emas edi. Bular test to'plami umuman ko'ra olmaydigan stsenariylar edi. Sandbox kerak, lekin yetarli bo'lishdan juda uzoq, va ikkisi orasidagi bo'shliqda sayohat integratsiyasining eng qimmatga tushadigan hodisalarining ko'pi yashaydi.
Bu o'sha integratsiyaga mas'ul developer uchun test rejasi: sandbox nimani isbotlay oladi, tabiatiga ko'ra nimani isbotlay olmaydi va farqni kompaniya kartasi bilan haqiqiy o'rindiqlarni bron qilmasdan qanday yopish mumkin.
Sandboxdan o'tgan kod nega production'da buziladi
Sandbox — javoblarning xatti-harakati haqida emas, shakli haqidagi va'da. Sxema production bilan mos keladi. Xatti-harakat esa deyarli hech qachon — va bunda hech kimning aybi yo'q: test muhiti jonli inventarni ko'tara olmaydi, shuning uchun hech qachon sotilib tugamaydigan, narxi va jadvali o'zgarmaydigan qat'iy tarif va xonalar to'plamini beradi. Undan boshqa hech kim foydalanmagani uchun tez javob beradi. Kamdan-kam yarim yo'lda to'xtaydi.
Production bularning hammasini har kuni qiladi. Inventar boshqa barcha sotuvchilar bilan bo'lishiladi; tariflarni yuqoridagi kimdir keshda saqlaydi va ular eskiradi; yuklama ostidagi yetkazib beruvchi tizimi sekin javob beradi yoki umuman javob bermaydi. Faqat sandboxni ko'rgan kod amalda faqat a'lo kun o'tkazayotgan yetkazib beruvchiga qarshi sinalgan.
Shuning uchun sandboxni uch qatlamdan biri deb biling. U so'rovlar to'g'ri tuzilganini va parser sxemani tushunishini isbotlaydi. Yozib olingan fixture'lar kod production haqiqatan yuboradigan javoblarga bardosh berishini isbotlaydi. Kichik, o'ylangan jonli tekshiruvlar to'plami esa biror narsa o'zgargandan keyin ulanishlar ishlashini isbotlaydi. Har bir qatlam qolgan ikkisi ushlay olmaganini ushlaydi.
Sandbox odatda bermaydigan stsenariylar
Birinchi testni yozishdan oldin ularni yozib qo'ying. Sandbox ulardan bir-ikkitasini maxsus test qiymati bilan taqlid qilishi mumkin; ko'pchiligi esa unda shunchaki yo'q.
| Stsenariy | Production nima qiladi | Qanday qamrab olish kerak |
|---|---|---|
| Narx qidiruv va bron orasida o'zgaradi | Bron boshqa summa bilan o'tadi yoki ko'rsatishingiz kerak bo'lgan narx o'zgarishi xatosi bilan tushadi | Fixture jufti: summasi farq qiladigan qidiruv va bron javobi; sayohatchidan qayta so'ralishini, jimgina pul yechilmasligini tekshiring |
| Mavjudlik va bron orasida sotilib tugaydi | Taklif qilingan xona yoki tarif klassi ushlab qolmoqchi bo'lganingizda allaqachon yo'q | Yetkazib beruvchining haqiqiy "sotilib tugadi" xatosi fixture'i; sayohatchi xato sahifasiga emas, natijalarga qaytishini tekshiring |
| Bron chaqiruvida timeout | Yetkazib beruvchi bronni yaratgan bo'lishi ham, yaratmagan bo'lishi ham mumkin | So'rov yuborilgandan keyin timeout kiriting; har qanday qayta urinishdan oldin bron holati so'ralishini tekshiring |
| Takroriy yuborish | Ikki marta bosish yoki mijoz tomonidagi qayta urinish ikki bron yaratadi | Bitta bronni bitta idempotency key bilan ikki marta yuboring; aynan bitta bron borligini tekshiring |
| Chipta yozilgandan keyin jadval o'zgarishi | Siz sotgan reys endi boshqa vaqtda yoki boshqa reys raqami bilan uchadi | O'zgartirilgan marshrut fixture'i; o'zgarish mijozga qarovchi kishiga yetib borishini tekshiring |
| Bir nechta xizmatli bronda qisman muvaffaqiyat | Reys tasdiqlanadi, mehmonxona esa yo'q | Aralash fixture; tizim nima tasdiqlanganini aniq yozib, odamga xabar berishini tekshiring |
| Yuklama ostida throttling | Rate limit javoblari, keyin sekin javoblar | Yozib olingan throttling javobini qayta ijro eting; backoff'ni va qidiruv xato berish o'rniga sekinlashishini tekshiring |
O'z stack'ingiz uchun oxirgi ustun bilan rozi bo'lmasligingiz mumkin. Mayli. Muhimi, har bir qatorning egasi va assertion'i bo'lsin, chunki ularning har biri ertami-kechmi boshingizga tushadi.
Fixture'larni to'qilgan emas, haqiqiy javoblardan quring
Sayohat integratsiyasidagi eng foydali odat — sizni hayratga solgan javoblarni saqlab qolish. Qo'lda yozilgan mock ma'lumotlar yetkazib beruvchi nima yuboradi deb o'ylashingizni aks ettiradi; yozib olingan javob esa u haqiqatan nima yuborganini aks ettiradi — hujjatlarda hech qachon bo'sh bo'lmaydi deyilgan bo'sh maydonlar, siz so'ramagan valyutadagi narx va muvaffaqiyat statusi bilan keladigan xato ham shunga kiradi.
Ishlaydigan tartib:
- Chegarada yozib oling. Yetkazib beruvchi chaqiruvlarining xom so'rov va javob tanalarini production bo'lmagan muhitda, maxfiylik qoidalaringiz ruxsat bersa, production'da esa trafikning tanlab olingan qismi uchun log qiling.
- Saqlashdan oldin tozalang. Yo'lovchilar ismlari, pasport raqamlari, e-pochtalar, telefonlar va to'lov havolalari fixture repozitoriyga tushishidan oldin olib tashlanadi. Ularni ochiq-oydin soxta qiymatlar bilan almashtiring, toki hech kim fixture'ni haqiqiy bron deb o'ylamasin.
- Fixture'larga xatti-harakatga qarab nom bering.
hotel-book-price-increased.jsonkeyingi developerga u nega borligini aytadi;response-17.jsonesa aytmaydi. - Xunuklarini abadiy saqlang. Bir yakshanba qidiruvni yiqitgan buzuq javob sizdagi eng qimmatli fayl. Uning joyi har bir commit'da ishlaydigan testda.
Keyin shu fixture'lar ustida contract testlar yozing: parser, ichki modellarga mapping, xatolar tasnifi. Yetkazib beruvchi maydon nomini o'zgartirsa va contract test yiqilsa, buni mijozdan emas, CI'dan bilib olasiz. Tasnif qismi bron tizimi API xatolarini boshqarish haqidagi maqolamizda batafsilroq yoritilgan.
Pul oqimlarini pul sarflamasdan sinash
Bu yerda sandbox eng kam yordam beradi, chunki pul oqimlari aynan test muhiti haqiqiysidan farq qiladigan joy. Haqiqiy chipta yozish, kartadan haqiqiy pul yechish va yetkazib beruvchining haqiqiy hisob-fakturasi — eng ko'p to'g'ri qilishingiz kerak va jonli mashq qila oladigan eng kam narsalar.
Muammoni bo'ling. Narx hisob-kitobi sof mantiq va uni oflayn to'liq sinash mumkin: yozib olingan tariflarni oling, markup qoidalaringizni, valyuta konvertatsiyasini va yaxlitlashni qo'llang, so'ng sayohatchi ko'radigan yakuniy summani tekshiring. Buni noqulay holatlar uchun qiling — bir valyutadagi tarifni boshqa valyutada sotish, bir mahsulotda foiz, boshqasida qat'iy summa bo'lgan markup, bolalar tarifi, ko'rsatish va to'lov orasida farq qiladigan yaxlitlash. Bir necha so'mga noto'g'ri bo'lgan summa baribir noto'g'ri va u har bir bronda noto'g'ri.
To'lov atrofidagi holat o'tishlari — ikkinchi yarmi. Ularni aniq modellashtiring — narxlangan, ushlab qolingan, to'langan, tasdiqlangan, chipta yozilgan, bekor qilingan, qaytarilgan — va har bir o'tishning aynan bitta sababi borligini sinang. Eng qimmat bug'ni ushlaydigan test — yetkazib beruvchi tasdiqlamagan bron uchun to'lov yechib bo'lmasligini va to'lov yozuvisiz tasdiqlangan bron mavjud bo'lolmasligini tekshiradigan test.
Va nihoyat, test yurishi haqiqiy chipta yozishga yetib borishini imkonsiz qiling. Ehtimoli past emas — imkonsiz. Production hisob ma'lumotlari yuklanganda to'plamni ishga tushirishdan bosh tortadigan ishga tushish tekshiruvi bir qatorga tushadi va integratsiya jamoasi boshdan kechirishi mumkin bo'lgan eng yomon tongning oldini oladi.
Xato qilsangiz bu sizga qanchaga tushadi
Sayohat integratsiyasida o'tkazib yuborilgan stsenariy kamdan-kam xato sifatida ko'rinadi. U joyida turgandek ko'rinadigan bron sifatida ko'rinadi. Hech kim so'ramagan va kimdir muddatdan oldin bekor qilishi kerak bo'lgan dublikat chipta. Agentlik endi o'z hisobidan qoplashi kerak bo'lgan narxda tasdiqlangan mehmonxona. Tizim qayta uringan timeout'li bron — yetkazib beruvchi ikki xonani ushlab, ikkalasiga ham hisob yozadi. Agentlik orqali sotilgan aviachipta uchun yozilgan va sotilgan narsa orasidagi nomuvofiqlik keyinroq ADM bo'lib qaytishi mumkin — o'sha savdoning marjasi allaqachon sarflanib bo'lgandan ancha keyin.
Bu xarajatlar retry siklini yozgan developerga emas, safarni sotgan biznesga tushadi. Ularni qo'llab-quvvatlash tiketlari orqali birma-bir o'rganish o'rniga ishga tushirishdan oldin sinashning butun dalili shu.
Har bir yetkazib beruvchi o'zgarishidan keyin nimani smoke test qilish kerak
Yetkazib beruvchilar narsalarni o'zgartiradi: yangi API versiyasi, yangi endpoint, almashtirilgan hisob ma'lumoti, boshqacha kontent mapping'i. Sizning kodingiz umuman o'zgarmagan bo'lishi mumkin. Baribir bu ro'yxatni o'zgargan yetkazib beruvchi bilan gaplashadigan muhitda ishga tushiring:
- O'sha yetkazib beruvchidan sotadigan har bir mahsulot uchun natija qaytarishini biladigan yo'nalish yoki shahar bo'yicha bitta qidiruv.
- Hech birini jimgina tashlab yubormasdan har bir natijani parse qiling; o'z hisobingizni xom javobdagi bilan solishtiring.
- Bitta natijaning narxini boshidan oxirigacha hisoblang va ko'rsatilgan summani xom tarifdan o'zingiz hisoblaganingiz bilan solishtiring.
- Test muhitida bron qiling, holatini qayta o'qing va saqlaydigan har bir maydonni solishtiring.
- Uni bekor qiling va bekor qilish o'z yozuvlaringizda ham, yetkazib beruvchi tomonida ham ko'rinishini tasdiqlang.
- Saqlangan xunuk fixture'laringizni yangi parserdan o'tkazing.
- Timeout va rate limit'lar hali ham siz tanlagan xatti-harakatga olib borishini tekshiring, chunki yangi versiya ularga boshqacha javob berishi mumkin. Javob vaqtlari siljigan bo'lsa, kechikish haqidagi maqola uning qaysi qismini o'zingiz tuzata olishingizni tushuntiradi.
Har safar ishga tushirish uchun yetarlicha qisqa — gap ham shunda. Bir kun olgani uchun hech kim ishga tushirmaydigan smoke test smoke test emas.
Sandboxning o'rni
Bularning hech biri sandboxni kamroq foydali qilmaydi. Uni halol qiladi: fixture'lar va jonli tekshiruvlar u yeta olmaydigan qismlarni o'z zimmasiga olishidan oldin sxemani o'rganadigan va so'rovlar to'g'riligini tasdiqlaydigan joy. Platformaning reys va mehmonxona API'larini baholayotgan bo'lsangiz, kirish self-service kalit bilan emas, suhbat bilan boshlanadi — bu test rejasini o'sha suhbatga olib keling va yuqoridagi jadvalning har bir qatori qanday qamrab olinishini so'rang. Javoblar sizga API haqida uning hujjatlaridan ko'ra ko'proq narsani aytadi.