Majaribio ya sandbox ya API ya usafiri: yasiyoonekana

Muunganisho ulipita kila kitu ambacho majaribio ya sandbox ya API ya usafiri yangeweza kuurushia. Utafutaji ulirudisha safari za ndege, ombi la upatikanaji wa hoteli lilirudi na vyumba, ombi la booking lilirudisha namba ya uthibitisho kila mara, na timu ya QA ikaidhinisha siku ya Alhamisi. Jumanne iliyofuata mteja alilipia hoteli kwa bei moja na msambazaji akaithibitisha kwa bei nyingine, booking ya ndege ilikatika kwa muda (timeout) na hakuna aliyeweza kusema kama kiti kilikuwa kimeshikiliwa, na wakala wa huduma kwa wateja alitumia mchana mzima kupatanisha rekodi mbili zilizoelezea safari ileile. Hakuna kati ya hayo lililokuwa hitilafu iliyopitwa na seti ya majaribio. Lilikuwa hali ambayo seti ya majaribio haikuwahi kuwa na njia ya kuiona. Sandbox ni ya lazima, lakini haitoshi hata kidogo, na pengo kati ya mambo hayo mawili ndipo yanapoishi matukio mengi ya gharama kubwa katika muunganisho wa usafiri.
Huu ni mpango wa majaribio kwa msanidi anayemiliki muunganisho huo: kile ambacho sandbox inaweza kuthibitisha, kile ambacho kimuundo haiwezi, na jinsi ya kuziba tofauti hiyo bila kununua viti halisi kwa kadi ya kampuni.
Kwa nini majaribio ya sandbox ya API ya usafiri hupitisha msimbo ambao production huuvunja
Sandbox ni ahadi kuhusu umbo la majibu, si kuhusu tabia yake. Schema inalingana na production. Tabia karibu kamwe hailingani, kwa sababu ambazo si kosa la mtu yeyote: mazingira ya majaribio hayawezi kumudu kuendesha orodha halisi ya bidhaa (inventory), kwa hiyo hutoa seti isiyobadilika ya nauli na vyumba ambavyo havijai kamwe, haviwekewi bei upya kamwe na havibadilishi ratiba kamwe. Hujibu haraka kwa sababu hakuna mwingine anayeitumia. Mara chache hushindwa katikati ya mchakato.
Production hufanya mambo hayo yote kila siku. Inventory inashirikiwa na kila muuzaji mwingine; nauli huhifadhiwa kwenye cache na mtu fulani wa juu katika mnyororo na hupitwa na wakati; mfumo wa msambazaji ukiwa na mzigo mkubwa hujibu polepole au haujibu kabisa. Msimbo ambao umewahi kuona sandbox pekee, kwa kweli, umejaribiwa tu dhidi ya msambazaji aliye na siku kamilifu.
Kwa hiyo ichukulie sandbox kama tabaka moja kati ya matatu. Inathibitisha kwamba maombi yako yameundwa ipasavyo na kwamba parser yako inaielewa schema. Fixtures zilizorekodiwa zinathibitisha kwamba msimbo wako unastahimili majibu ambayo production hutuma kwa kweli. Seti ndogo, ya makusudi, ya ukaguzi wa moja kwa moja (live) inathibitisha miunganisho baada ya kitu kubadilika. Kila tabaka hunasa kile ambacho mengine mawili hayawezi.
Hali ambazo kwa kawaida sandbox haiwezi kukupa
Ziandike hizi kabla hujaandika jaribio hata moja. Sandbox inaweza kuiga moja au mbili kati yake kwa thamani maalum ya majaribio; nyingi kati yake haina kabisa.
| Hali | Production hufanya nini | Jinsi ya kuishughulikia |
|---|---|---|
| Bei hubadilika kati ya utafutaji na booking | Ombi la booking linafaulu kwa jumla tofauti, au linashindwa kwa hitilafu ya mabadiliko ya bei ambayo lazima uionyeshe | Jozi ya fixtures: jibu la utafutaji na jibu la booking lenye jumla tofauti; thibitisha kwamba msafiri anaulizwa tena, kamwe asitozwe kimyakimya |
| Nafasi zinakwisha kati ya upatikanaji na booking | Chumba au daraja la nauli lililotolewa limekwisha unapojaribu kulishikilia | Fixture ya hitilafu halisi ya msambazaji ya nafasi kwisha; thibitisha kwamba msafiri anarudi kwenye matokeo, si kwenye ukurasa wa hitilafu |
| Timeout kwenye ombi la booking | Msambazaji anaweza kuwa ameunda booking au hajaunda | Ingiza timeout baada ya ombi kutumwa; thibitisha kwamba unauliza hali ya booking kabla ya kitu chochote kujaribu tena |
| Uwasilishaji maradufu | Kubofya mara mbili au mteja kujaribu tena huunda booking mbili | Tuma booking ileile mara mbili kwa idempotency key ileile; thibitisha kwamba booking moja tu ipo |
| Mabadiliko ya ratiba baada ya tiketi kutolewa | Ndege uliyouza sasa inaondoka saa nyingine, au chini ya namba nyingine ya ndege | Fixture ya ratiba iliyobadilishwa; thibitisha kwamba mabadiliko yanamfikia anayemiliki uhusiano na mteja |
| Mafanikio ya sehemu kwenye booking yenye vipengele vingi | Ndege inathibitishwa na hoteli haithibitishwi | Fixture mchanganyiko; thibitisha kwamba mfumo unarekodi hasa kilichothibitishwa na kumtahadharisha binadamu |
| Kuzuiwa kasi (throttling) wakati wa mzigo | Majibu ya kikomo cha kasi, kisha majibu ya polepole | Rudia jibu la throttling lililorekodiwa; thibitisha backoff, na kwamba utafutaji unapungua ubora badala ya kutoa hitilafu |
Huenda hukubaliani na safu ya mwisho kwa mfumo wako. Sawa. Kinachojalisha ni kwamba kila mstari una mmiliki na uthibitisho (assertion), kwa sababu kila mmoja hatimaye utakutokea.
Jenga fixtures kutokana na majibu halisi, si ya kubuni
Tabia yenye manufaa zaidi katika muunganisho wa usafiri ni kuhifadhi majibu yaliyokushangaza. Data ya mock iliyoandikwa kwa mkono inaakisi kile unachodhani msambazaji hutuma; jibu lililorekodiwa linaakisi kile alichotuma kwa kweli, pamoja na sehemu zilizo tupu ilhali nyaraka zinasema hazitakuwa tupu kamwe, bei katika sarafu ambayo hukuiomba, na hitilafu inayofika na hali ya mafanikio.
Utaratibu unaofanya kazi:
- Rekodi mpakani. Hifadhi miili ghafi ya maombi na majibu ya miito kwa msambazaji katika mazingira yasiyo ya production, na katika production kwa sehemu ya sampuli ya trafiki ikiwa sheria zako za faragha zinaruhusu.
- Safisha kabla ya kuhifadhi. Majina ya abiria, namba za pasipoti, barua pepe, namba za simu na marejeo ya malipo huondolewa kabla fixture haijaingia kwenye hazina ya msimbo. Yabadilishe kwa thamani bandia zilizo dhahiri ili mtu yeyote asidhani fixture ni booking halisi.
- Zipe fixtures majina kwa tabia.
hotel-book-price-increased.jsoninamweleza msanidi anayefuata kwa nini ipo;response-17.jsonhaielezi. - Hifadhi zile mbaya milele. Jibu lililoharibika lililoangusha utafutaji Jumapili moja ndilo faili la thamani zaidi ulilonalo. Linastahili kuwa kwenye jaribio linaloendeshwa kila commit.
Kisha andika majaribio ya mkataba (contract tests) dhidi ya fixtures hizo: parser yako, upangaji wako kwenda kwenye modeli za ndani, na uainishaji wako wa hitilafu. Msambazaji akibadilisha jina la sehemu na jaribio la mkataba likashindwa, unajifunza hilo kwenye CI badala ya kutoka kwa mteja. Upande wa uainishaji umeelezwa kwa kina zaidi katika makala yetu kuhusu kushughulikia hitilafu za API ya booking engine.
Kujaribu njia za fedha bila kutumia fedha
Hapa ndipo sandbox husaidia kidogo zaidi, kwa sababu njia za fedha ndizo hasa mahali ambapo mazingira ya majaribio hutofautiana na yale halisi. Utoaji halisi wa tiketi, ukataji halisi wa kadi na ankara halisi za msambazaji ndivyo unavyohitaji zaidi kuvipata sawa na ndivyo usivyoweza kuvifanyia mazoezi moja kwa moja.
Gawanya tatizo. Hesabu za bei ni mantiki tupu na zinaweza kujaribiwa kikamilifu nje ya mtandao: chukua nauli zilizorekodiwa, tumia kanuni zako za faida (markup), ubadilishaji wa sarafu na ukadiriaji, na uthibitishe jumla ambayo msafiri anaiona. Fanya hivyo kwa hali ngumu — nauli katika sarafu moja inayouzwa kwa nyingine, markup ambayo ni asilimia kwenye bidhaa moja na kiasi kisichobadilika kwenye nyingine, nauli ya mtoto, hatua ya ukadiriaji inayotofautiana kati ya kuonyesha na kutoza. Jumla iliyokosewa kwa vipande vichache vya sarafu bado imekosewa, na imekosewa kwenye kila booking.
Mabadiliko ya hali yanayozunguka malipo ni nusu ya pili. Yaigize waziwazi — imenukuliwa, imeshikiliwa, imelipwa, imethibitishwa, tiketi imetolewa, imeghairiwa, imerejeshewa fedha — na ujaribu kwamba kila badiliko lina chanzo kimoja tu. Jaribio linalonasa hitilafu ya gharama kubwa zaidi ni lile linalothibitisha kwamba malipo hayawezi kukatwa kwa booking ambayo msambazaji hajaithibitisha, na kwamba booking iliyothibitishwa haiwezi kuwepo bila rekodi ya malipo.
Mwisho, fanya iwe haiwezekani kwa majaribio kufikia utoaji halisi wa tiketi. Si kwamba haielekei; haiwezekani. Ukaguzi wa mwanzo unaokataa kuendesha seti ya majaribio pale vitambulisho vya production vimepakiwa unagharimu mstari mmoja na unazuia asubuhi mbaya zaidi ambayo timu ya muunganisho inaweza kuwa nayo.
Gharama yake ukikosea
Hali iliyosahaulika katika muunganisho wa usafiri mara chache huonekana kama hitilafu. Huonekana kama booking inayoonekana sawa. Tiketi maradufu ambayo hakuna aliyeiomba, ambayo mtu lazima aibatilishe kabla ya muda wa mwisho. Hoteli iliyothibitishwa kwa bei ambayo sasa wakala analazimika kuibeba. Booking iliyokatika kwa timeout ambayo mfumo uliijaribu tena, kwa hiyo msambazaji anashikilia vyumba viwili na kutoza ankara kwa vyote viwili. Kwa tiketi ya ndege inayouzwa kupitia wakala, kutolingana kati ya kilichotolewa na kilichouzwa kunaweza kurudi baadaye kama ADM, muda mrefu baada ya faida ya mauzo hayo kutumika.
Gharama hizo huangukia biashara iliyouza safari, si msanidi aliyeandika kitanzi cha kujaribu tena. Hiyo ndiyo hoja nzima ya kuzijaribu kabla ya uzinduzi badala ya kujifunza moja baada ya nyingine kupitia tiketi za huduma kwa wateja.
Nini cha kufanyia smoke test baada ya kila mabadiliko ya msambazaji
Wasambazaji hubadilisha mambo: toleo jipya la API, endpoint mpya, kitambulisho kilichozungushwa, upangaji tofauti wa maudhui. Huenda msimbo wako mwenyewe haujabadilika kabisa. Endesha orodha hii hata hivyo, katika mazingira yanayozungumza na msambazaji aliyebadilika:
- Utafutaji mmoja kwa kila bidhaa unayouza kutoka kwa msambazaji huyo, kwenye njia au jiji unalojua linarudisha matokeo.
- Changanua kila tokeo bila kudondosha lolote kimyakimya; linganisha idadi yako na kile kilichomo kwenye jibu ghafi.
- Weka bei kwa tokeo moja kuanzia mwanzo hadi mwisho na ulinganishe jumla inayoonyeshwa na hesabu yako mwenyewe kutokana na nauli ghafi.
- Fanya booking katika mazingira ya majaribio, soma hali yake tena na ulinganishe kila sehemu unayoihifadhi.
- Ighairi na uthibitishe kwamba kughairiwa kunaonekana kwenye rekodi zako na upande wa msambazaji pia.
- Pitisha tena fixtures zako mbaya ulizohifadhi kupitia parser mpya.
- Kagua kwamba timeouts na vikomo vya kasi bado vinaelekea kwenye tabia uliyoiamua, kwa sababu toleo jipya linaweza kuvijibu tofauti. Ikiwa muda wa majibu umebadilika, makala kuhusu ucheleweshaji inaeleza ni sehemu gani yake iliyo jukumu lako kurekebisha.
Ni fupi kiasi cha kuendeshwa kila mara, na hilo ndilo lengo. Smoke test ambayo hakuna anayeiendesha kwa sababu inachukua siku nzima si smoke test.
Sandbox inakaa wapi
Hakuna kati ya haya kinachoifanya sandbox isiwe na manufaa. Kinaifanya iwe ya kweli: mahali unapojifunza schema na kuthibitisha kwamba maombi ni sahihi, kabla fixtures na ukaguzi wa moja kwa moja havijachukua sehemu ambazo haiwezi kuzifikia. Ikiwa unatathmini API za ndege na hoteli za jukwaa hili, ufikiaji huanza kama mazungumzo badala ya ufunguo wa kujihudumia — leta mpango huu wa majaribio kwenye mazungumzo hayo na uulize jinsi kila mstari wa jedwali hapo juu ungeshughulikiwa. Majibu yatakueleza mengi zaidi kuhusu API kuliko nyaraka zake.