Səyahət API-sının sandbox testi: sandbox-un göstərmədikləri

İnteqrasiya səyahət API-sının sandbox testinin qarşısına çıxara biləcəyi hər şeydən keçdi. Axtarış uçuşlar qaytarırdı, otel əlçatanlıq sorğusu boş otaqlarla gəlirdi, bron çağırışı hər dəfə təsdiq nömrəsi verirdi və QA cümə axşamı imza atdı. Növbəti çərşənbə axşamı bir müştəri oteli bir qiymətə ödədi, təchizatçı isə başqa qiymətə təsdiqlədi; bir uçuş bronu timeout-a düşdü və heç kim yerin saxlanılıb-saxlanılmadığını deyə bilmədi; dəstək əməkdaşı isə günortanı eyni səyahəti təsvir edən iki qeydi uzlaşdırmağa sərf etdi. Bunların heç biri test dəstinin qaçırdığı bug deyildi. Bunlar test dəstinin ümumiyyətlə görə bilmədiyi ssenarilər idi. Sandbox lazımdır, amma kifayət olmaqdan çox uzaqdır və bu ikisinin arasındakı boşluqda səyahət inteqrasiyasının ən baha başa gələn insidentlərinin çoxu yaşayır.
Bu, həmin inteqrasiyaya cavabdeh olan developer üçün test planıdır: sandbox nəyi sübut edə bilər, təbiətinə görə nəyi edə bilməz və fərqi şirkət kartı ilə real yerlər bron etmədən necə örtmək olar.
Sandbox-dan keçən kod niyə istehsalda sınır
Sandbox cavabların davranışı haqqında deyil, forması haqqında vəddir. Sxem istehsalla üst-üstə düşür. Davranış isə demək olar ki, heç vaxt — və bunda heç kimin günahı yoxdur: test mühiti canlı inventar saxlaya bilməz, ona görə də heç vaxt satılıb qurtarmayan, qiyməti və cədvəli dəyişməyən sabit tarif və otaq dəsti verir. Onu başqa heç kim istifadə etmədiyi üçün sürətli cavab verir. Nadir hallarda yarıda dayanır.
İstehsal bunların hamısını hər gün edir. İnventar bütün digər satıcılarla paylaşılır; tarifləri yuxarıda kimsə keşdə saxlayır və onlar köhnəlir; yük altında olan təchizatçı sistemi yavaş cavab verir və ya heç cavab vermir. Yalnız sandbox görmüş kod əslində yalnız mükəmməl gün keçirən təchizatçıya qarşı test edilib.
Ona görə sandbox-a üç qatdan biri kimi baxın. O, sorğuların düzgün qurulduğunu və parserin sxemi başa düşdüyünü sübut edir. Yazılmış fixture-lar kodun istehsalın həqiqətən göndərdiyi cavablara dözdüyünü sübut edir. Kiçik, düşünülmüş canlı yoxlamalar dəsti isə nəsə dəyişəndən sonra əlaqələrin işlədiyini sübut edir. Hər qat digər ikisinin tuta bilmədiyini tutur.
Sandbox-un adətən vermədiyi ssenarilər
Bunları ilk testi yazmazdan əvvəl qeyd edin. Sandbox onlardan bir-ikisini xüsusi test dəyəri ilə imitasiya edə bilər; çoxu isə sadəcə onda yoxdur.
| Ssenari | İstehsal nə edir | Necə örtmək olar |
|---|---|---|
| Qiymət axtarışla bron arasında dəyişir | Bron başqa məbləğlə uğurlu olur və ya göstərməli olduğunuz qiymət dəyişikliyi xətası ilə düşür | Fixture cütü: fərqli məbləğli axtarış və bron cavabı; səyyahdan yenidən soruşulduğunu, səssizcə pul tutulmadığını yoxlayın |
| Əlçatanlıqla bron arasında satılıb qurtarır | Təklif olunan otaq və ya tarif sinfi saxlamağa çalışanda artıq yoxdur | Təchizatçının real "satılıb" xətasının fixture-ı; səyyahın xəta səhifəsinə deyil, nəticələrə qayıtdığını yoxlayın |
| Bron çağırışında timeout | Təchizatçı bronu yaratmış da ola bilər, yaratmamış da | Sorğu göndəriləndən sonra timeout yeridin; hər hansı təkrar cəhddən əvvəl bron statusunun sorğulandığını yoxlayın |
| Təkrar göndərmə | İkiqat klik və ya müştəri tərəfindən təkrar iki bron yaradır | Eyni bronu eyni idempotency key ilə iki dəfə göndərin; tam olaraq bir bronun olduğunu yoxlayın |
| Bilet yazılandan sonra cədvəl dəyişikliyi | Satdığınız reys indi başqa vaxtda və ya başqa reys nömrəsi ilə uçur | Dəyişdirilmiş marşrut fixture-ı; dəyişikliyin müştəriyə baxan şəxsə çatdığını yoxlayın |
| Çoxxidmətli bronda qismən uğur | Uçuş təsdiqlənir, otel isə yox | Qarışıq fixture; sistemin nəyin təsdiqləndiyini dəqiq qeyd etdiyini və insana xəbər verdiyini yoxlayın |
| Yük altında throttling | Rate limit cavabları, sonra yavaş cavablar | Yazılmış throttling cavabını təkrarlayın; backoff-u və axtarışın xəta vermək əvəzinə zəiflədiyini yoxlayın |
Öz stack-iniz üçün son sütunla razılaşmaya bilərsiniz. Problem deyil. Əsas odur ki, hər sətrin sahibi və assertion-u olsun, çünki onların hər biri gec-tez başınıza gələcək.
Fixture-ları uydurulmuş deyil, real cavablardan qurun
Səyahət inteqrasiyasında ən faydalı vərdiş sizi təəccübləndirən cavabları saxlamaqdır. Əllə yazılmış mock məlumatlar təchizatçının nə göndərdiyini sizin necə təsəvvür etdiyinizi əks etdirir; yazılmış cavab isə onun həqiqətən nə göndərdiyini — sənədlərin heç vaxt boş olmadığını iddia etdiyi boş sahələri, istəmədiyiniz valyutadakı qiyməti və uğur statusu ilə gələn xətanı da daxil olmaqla.
İşləyən bir rutin:
- Sərhəddə yazın. Təchizatçı çağırışlarının xam sorğu və cavab gövdələrini istehsal olmayan mühitdə, məxfilik qaydalarınız icazə verirsə, istehsalda isə trafikin seçmə hissəsi üçün loglayın.
- Saxlamazdan əvvəl təmizləyin. Sərnişin adları, pasport nömrələri, e-poçtlar, telefonlar və ödəniş istinadları fixture repozitoriyaya düşməzdən əvvəl çıxarılır. Onları açıq-aşkar saxta dəyərlərlə əvəz edin ki, heç kim fixture-ı real bronla qarışdırmasın.
- Fixture-lara davranışa görə ad verin.
hotel-book-price-increased.jsonnövbəti developerə onun niyə mövcud olduğunu deyir;response-17.jsonisə demir. - Çirkinləri həmişəlik saxlayın. Bir bazar günü axtarışı çökdürən pozulmuş cavab sizdəki ən dəyərli fayldır. Onun yeri hər commit-də işləyən testdir.
Sonra bu fixture-lar üzərində contract testlər yazın: parser, daxili modellərə mapping, xətaların təsnifatı. Təchizatçı bir sahənin adını dəyişsə və contract test düşsə, bunu müştəridən deyil, CI-dan öyrənirsiniz. Təsnifat tərəfi bron sisteminin API xətalarının idarə olunması haqqında yazımızda daha ətraflı izah olunub.
Pul axınlarını pul xərcləmədən test etmək
Burada sandbox ən az kömək edir, çünki pul axınları məhz test mühitinin real mühitdən fərqləndiyi yerdir. Real bilet yazılması, kartdan real pul tutulması və təchizatçının real hesab-fakturası ən çox düz etməli olduğunuz və canlı məşq edə biləcəyiniz ən az şeylərdir.
Problemi bölün. Qiymət riyaziyyatı təmiz məntiqdir və oflayn tam test edilə bilər: yazılmış tarifləri götürün, markup qaydalarınızı, valyuta çevrilməsini və yuvarlaqlaşdırmanı tətbiq edin və səyyahın gördüyü yekunu yoxlayın. Bunu çətin hallar üçün edin — bir valyutada olan tarifin başqa valyutada satılması, bir məhsulda faiz, digərində sabit məbləğ olan markup, uşaq tarifi, göstərmə ilə ödəniş arasında fərqlənən yuvarlaqlaşdırma. Bir neçə manat səhv olan yekun yenə də səhvdir və hər bronda səhvdir.
Ödəniş ətrafındakı status keçidləri ikinci yarıdır. Onları açıq modelləşdirin — qiymətləndirilib, saxlanılıb, ödənilib, təsdiqlənib, bilet yazılıb, ləğv edilib, geri qaytarılıb — və hər keçidin tam bir səbəbi olduğunu test edin. Ən baha bug-ı tutan test təchizatçının təsdiqləmədiyi bron üçün ödəniş tutula bilməyəcəyini və ödəniş qeydi olmadan təsdiqlənmiş bronun mövcud ola bilməyəcəyini yoxlayan testdir.
Nəhayət, test icrasının real bilet yazılmasına çatmasını qeyri-mümkün edin. Az ehtimallı yox — qeyri-mümkün. İstehsal etimadnamələri yüklənəndə dəsti işə salmaqdan imtina edən başlanğıc yoxlaması bir sətir tutur və inteqrasiya komandasının yaşaya biləcəyi ən pis səhərin qarşısını alır.
Səhv etsəniz bu sizə neçəyə başa gəlir
Səyahət inteqrasiyasında qaçırılmış ssenari nadir hallarda xəta kimi görünür. O, qaydasında görünən bron kimi görünür. Heç kimin istəmədiyi və kiminsə son tarixdən əvvəl ləğv etməli olduğu dublikat bilet. Agentliyin indi öz cibindən ödəməli olduğu qiymətə təsdiqlənmiş otel. Sistemin təkrar cəhd etdiyi timeout-lu bron — təchizatçı iki otaq saxlayır və ikisinə də hesab kəsir. Agentlik vasitəsilə satılmış aviabilet üçün yazılanla satılan arasındakı uyğunsuzluq sonradan ADM kimi geri qayıda bilər, o satışın marjası çoxdan xərclənəndən sonra.
Bu xərclər retry dövrəsini yazan developerin deyil, səyahəti satan biznesin üzərinə düşür. Onları dəstək tiketləri ilə bir-bir öyrənmək əvəzinə işə salınmadan əvvəl test etməyin bütün arqumenti budur.
Hər təchizatçı dəyişikliyindən sonra nəyi smoke test etməli
Təchizatçılar nələrisə dəyişir: yeni API versiyası, yeni endpoint, yenilənmiş etimadnamə, fərqli kontent mapping-i. Sizin kodunuz heç dəyişməmiş ola bilər. Yenə də bu siyahını dəyişən təchizatçı ilə danışan mühitdə işlədin:
- O təchizatçıdan satdığınız hər məhsul üçün nəticə qaytardığını bildiyiniz marşrut və ya şəhər üzrə bir axtarış.
- Heç birini səssizcə atmadan hər nəticəni parse edin; saydığınızı xam cavabdakı ilə müqayisə edin.
- Bir nəticənin qiymətini əvvəldən axıra hesablayın və göstərilən yekunu xam tarifdən öz hesablamanızla müqayisə edin.
- Test mühitində bron edin, statusunu geri oxuyun və saxladığınız hər sahəni müqayisə edin.
- Onu ləğv edin və ləğvin həm öz qeydlərinizdə, həm də təchizatçı tərəfində göründüyünü təsdiqləyin.
- Saxladığınız çirkin fixture-ları yeni parserdən keçirin.
- Timeout və rate limit-lərin hələ də qərar verdiyiniz davranışa apardığını yoxlayın, çünki yeni versiya onlara fərqli cavab verə bilər. Cavab müddətləri dəyişibsə, gecikmə haqqında yazı bunun hansı hissəsini sizin düzəldə biləcəyinizi izah edir.
Hər dəfə işlətmək üçün kifayət qədər qısadır və məqsəd də budur. Bir gün çəkdiyi üçün heç kimin işlətmədiyi smoke test smoke test deyil.
Sandbox-un yeri
Bunların heç biri sandbox-u daha az faydalı etmir. Onu dürüst edir: fixture-lar və canlı yoxlamalar onun çatmadığı hissələri öz üzərinə götürməzdən əvvəl sxemi öyrəndiyiniz və sorğuların düzgün olduğunu təsdiqlədiyiniz yer. Platformanın uçuş və otel API-larını qiymətləndirirsinizsə, giriş self-service açarla deyil, söhbətlə başlayır — bu test planını həmin söhbətə gətirin və yuxarıdakı cədvəlin hər sətrinin necə örtüləcəyini soruşun. Cavablar sizə API haqqında onun sənədlərindən daha çox şey deyəcək.