Pređi na sadržaj
Blog

Тестирање travel API-ја у sandbox-у: шта вам неће показати

Редакција Tekravel
Napisano uz pomoć veštačke inteligencije

Интеграција је прошла све што јој је тестирање travel API-ја у sandbox-у могло да подметне. Претрага је враћала летове, упит о расположивости хотела враћао је собе, позив за резервацију сваки пут је враћао број потврде, а QA је одобрио у четвртак. Наредног уторка купац је платио хотел по једној цени, а добављач га је потврдио по другој; резервација лета је истекла и нико није знао да ли је место задржано; а радник подршке провео је поподне усклађујући два записа о истом путовању. Ништа од тога није био баг који су тестови промашили. Били су то сценарији које тестови никако нису могли да виде. Sandbox је неопходан, далеко од тога да је довољан, а у јазу између то двоје живи већина скупих инцидената једне туристичке интеграције.

Ово је план тестирања за програмера који одговара за ту интеграцију: шта sandbox може да докаже, шта по својој природи не може и како да покријете разлику, а да не резервишете права седишта службеном картицом.

Зашто тестирање travel API-ја у sandbox-у пропушта код који продукција ломи

Sandbox обећава нешто о облику одговора, не о њиховом понашању. Шема одговара продукцији. Понашање готово никад — и то није ничија кривица: тестно окружење не може себи да приушти живи инвентар, па нуди фиксни скуп тарифа и соба које се никад не распродају, не мењају цену и не мењају ред летења. Одговара брзо јер га нико други не користи. Ретко пада на пола посла.

Продукција све то ради свакодневно. Инвентар делите са свим осталим продавцима; тарифе неко више у ланцу држи у кешу и оне застаревају; систем добављача под оптерећењем одговара споро или никако. Код који је видео само sandbox практично је тестиран само против добављача који има савршен дан.

Зато sandbox посматрајте као један од три слоја. Он доказује да су захтеви исправно састављени и да парсер разуме шему. Снимљени fixtures доказују да код преживљава одговоре које продукција заиста шаље. Мали, намерно одабран скуп живих провера доказује повезаност након сваке промене. Сваки слој хвата оно што друга два не могу.

Сценарији које вам sandbox обично не даје

Запишите их пре него што напишете иједан тест. Sandbox можда симулира један или два помоћу неке „магичне“ тест вредности; већину једноставно нема.

СценариоШта ради продукцијаКако га покрити
Промена цене између претраге и резервацијеРезервација успева по другом укупном износу или пада са грешком о промени цене коју морате приказатиПар fixtures: одговор претраге и одговор резервације са различитим износом; проверите да се путник поново пита и никад не задужује тихо
Распродато између расположивости и резервацијеПонуђена соба или тарифна класа више не постоји када покушате да је задржитеFixture са стварном грешком добављача за распродато; проверите да се путник враћа на резултате, а не на страницу са грешком
Timeout при позиву резервацијеДобављач је можда направио резервацију, а можда нијеИзазовите timeout након слања захтева; проверите да питате за статус резервације пре било каквог поновног покушаја
Двоструко слањеДвоклик или поновни покушај клијента прави две резервацијеПошаљите исту резервацију двапут са истим idempotency key; проверите да постоји тачно једна
Промена реда летења након издавањаПродати лет сада полеће у друго време или под другим бројемFixture измењеног итинерера; проверите да промена стиже до онога ко води купца
Делимичан успех вишеделне резервацијеЛет се потврђује, хотел неМешовити fixture; проверите да систем бележи тачно оно што је потврђено и упозорава човека
Throttling под оптерећењемОдговори о rate limit-у, затим спори одговориПустите снимљени throttling одговор; проверите backoff и да претрага деградира уместо да пада

Можда се не слажете са последњом колоном за свој stack. У реду. Важно је да сваки ред има власника и assertion, јер ће вам се сваки од њих кад-тад десити.

Fixtures од правих одговора, не измишљених

Најкориснија навика у туристичкој интеграцији је чување одговора који су вас изненадили. Ручно писани mock подаци одражавају оно што мислите да добављач шаље; снимљени одговор показује шта је заиста послао — укључујући поља која су празна иако документација каже да никад нису, цену у валути коју нисте тражили и грешку која стиже са кодом успеха.

Рутина која функционише:

  • Снимајте на граници. Логујте сирова тела захтева и одговора ка добављачима у непродукционом окружењу, а у продукцији за узорак саобраћаја, ако ваша правила о заштити података то дозвољавају.
  • Очистите пре чувања. Имена путника, бројеви пасоша, имејлови, телефони и платне референце уклањају се пре него што fixture уђе у репозиторијум. Замените их очигледно лажним вредностима, да нико не помеша fixture са правом резервацијом.
  • Именујте по понашању. hotel-book-price-increased.json говори следећем програмеру зашто постоји; response-17.json не говори.
  • Ружне чувајте заувек. Неисправан одговор који је једне недеље срушио претрагу најдрагоценији је фајл који имате. Место му је у тесту који се покреће на сваком commit-у.

Затим напишите contract тестове над тим fixtures: за парсер, за мапирање у интерне моделе, за класификацију грешака. Ако добављач преименује поље и contract тест падне, сазнајете то у CI-ју, а не од купца. Класификацију детаљније обрађује наш текст о обради грешака у API-ју система за резервације.

Тестирање новчаних токова без трошења новца

Ту sandbox помаже најмање, јер се управо у новчаним токовима тестно окружење разликује од правог. Право издавање карата, право задуживање картице и право фактурисање добављача су ствари које најпре морају бити тачне, а које најмање можете увежбати уживо.

Поделите проблем. Обрачун цене је чиста логика и може се исцрпно тестирати офлајн: узмите снимљене тарифе, примените своја правила за markup, конверзију валуте и заокруживање, и проверите износ који путник види. Урадите то за незгодне случајеве — тарифа у еврима продата у динарима, markup који је на једном производу проценат а на другом фиксни износ, дечја тарифа, заокруживање које се разликује између приказа и задужења. Износ који одступа за неколико динара и даље је погрешан — и погрешан је на свакој резервацији.

Друга половина су прелази стања око плаћања. Моделујте их експлицитно — понуђено, задржано, плаћено, потврђено, издато, отказано, рефундирано — и проверите да сваки прелаз има тачно један узрок. Тест који хвата најскупљи баг проверава да се плаћање не може наплатити за резервацију коју добављач није потврдио и да потврђена резервација не може постојати без записа о плаћању.

На крају, учините немогућим да тестно покретање стигне до живог издавања карата. Не мало вероватним; немогућим. Провера при покретању која одбија да пусти тестове када су учитани продукциони креденцијали кошта један ред и спречава најгоре јутро које интеграциони тим може да доживи.

Колико вас кошта ако погрешите

Промашени сценарио у туристичкој интеграцији ретко се појави као грешка. Појави се као резервација која изгледа уредно. Дупла карта коју нико није тражио и коју неко мора да void-ује пре рока. Хотел потврђен по цени коју агенција сада мора сама да поднесе. Резервација са timeout-ом коју је систем поново покушао, па добављач држи две собе и фактурише обе. Код авио-карте продате преко агенције, неслагање између издатог и продатог може се касније вратити као ADM, дуго након што је маржа од те продаје потрошена.

Ти трошкови падају на фирму која је продала путовање, не на програмера који је написао retry петљу. У томе је цео аргумент да их тестирате пре покретања, уместо да их учите један тикет подршке за другим.

Шта проверити после сваке промене код добављача

Добављачи мењају ствари: нова верзија API-ја, нови endpoint, промењени креденцијали, другачије мапирање садржаја. Ваш код се можда уопште није променио. Прођите ову листу свеједно, у окружењу које разговара са промењеним добављачем:

  1. По једна претрага за сваки производ који продајете од тог добављача, на релацији или у граду за који знате да враћа резултате.
  2. Обрадите сваки резултат а да ниједан тихо не испадне; упоредите свој број са оним што садржи сирови одговор.
  3. Обрачунајте један резултат од почетка до краја и упоредите приказани износ са сопственим прорачуном из сирове тарифе.
  4. Направите резервацију у тестном окружењу, прочитајте назад њен статус и упоредите свако поље које чувате.
  5. Откажите је и потврдите да је отказивање видљиво и у вашим записима и код добављача.
  6. Провуците сачуване ружне fixtures кроз нови парсер.
  7. Проверите да timeout-и и rate limit-и и даље воде понашању о ком сте се договорили, јер нова верзија може на њих одговарати другачије. Ако су се времена одзива померила, текст о латенцији објашњава који део је ваш да поправите.

Довољно кратко да се пушта сваки пут — и то је поента. Smoke тест који нико не покреће јер траје цео дан није smoke тест.

Где је место sandbox-у

Ништа од овога не чини sandbox мање корисним. Чини га поштеним: место где учите шему и потврђујете да су захтеви исправни, пре него што fixtures и живе провере преузму оно до чега он не досеже. Ако процењујете API-је платформе за летове и хотеле, приступ почиње разговором, а не кључем на самоуслузи — донесите овај план тестирања на тај разговор и питајте како би био покривен сваки ред горње табеле. Одговори ће вам рећи више о једном API-ју него његова документација.

Редакција Tekravel

Деск за путничке технологије

Деск за путничке технологије Tekravel-а пише за струку: власнике агенција, консолидаторе и програмере који их интегришу. Сваки чланак се пре објаве проверава на платформи коју описује.