Мазмұнға өту
Блог

Туристік API-ді sandbox-та тестілеу: ол нені көрсетпейді

Tekravel редакциясы
Жасанды интеллекттің көмегімен жазылған

Интеграция туристік API-ді sandbox-та тестілеу оған қарсы қоя алатынның бәрінен өтті. Іздеу рейстерді қайтарды, қонақүй қолжетімділігі сұранысы бос нөмірлермен келді, брондау шақыруы әр жолы растау нөмірін берді, ал QA бейсенбі күні қол қойды. Келесі сейсенбіде клиент қонақүйге бір бағамен төледі, ал жеткізуші оны басқа бағамен растады; рейс брондауы timeout-қа түсіп, орын ұсталды ма, жоқ па — ешкім айта алмады; қолдау қызметкері түстен кейінгі уақытын бір сапарды сипаттайтын екі жазбаны салыстыруға жұмсады. Мұның бірде-біреуі тест жиынтығы өткізіп алған баг емес еді. Бұлар тест жиынтығы мүлде көре алмайтын сценарийлер болатын. Sandbox қажет, бірақ жеткілікті болудан өте алыс, ал осы екеуінің арасындағы саңылауда туристік интеграцияның ең қымбатқа түсетін оқиғаларының көбі тұрады.

Бұл — сол интеграцияға жауапты әзірлеушіге арналған тест жоспары: sandbox нені дәлелдей алады, табиғаты бойынша нені дәлелдей алмайды және айырмашылықты компания картасымен нақты орындар брондамай қалай жабуға болады.

Sandbox-тан өткен код неге продакшнда сынады

Sandbox — жауаптардың мінез-құлқы туралы емес, пішіні туралы уәде. Схема продакшнмен сәйкес келеді. Мінез-құлық дерлік ешқашан сәйкес келмейді, және бұған ешкім кінәлі емес: тест ортасы тірі инвентарды көтере алмайды, сондықтан ешқашан сатылып бітпейтін, бағасы мен кестесі өзгермейтін тұрақты тарифтер мен нөмірлер жиынтығын береді. Оны басқа ешкім пайдаланбағандықтан, тез жауап береді. Сирек жағдайда ғана жартыда тоқтайды.

Продакшн мұның бәрін күн сайын жасайды. Инвентарь басқа барлық сатушылармен бөлісіледі; тарифтерді жоғарыдағы біреу кэште сақтайды да, олар ескіреді; жүктеме астындағы жеткізуші жүйесі баяу жауап береді немесе мүлде жауап бермейді. Тек sandbox көрген код іс жүзінде тек тамаша күн өткізіп жатқан жеткізушіге қарсы ғана тексерілген.

Сондықтан sandbox-ты үш қабаттың бірі ретінде қарастырыңыз. Ол сұраныстардың дұрыс құрылғанын және парсердің схеманы түсінетінін дәлелдейді. Жазылған фикстуралар кодтың продакшн шынымен жіберетін жауаптарға төтеп беретінін дәлелдейді. Шағын, ойластырылған тірі тексерулер жиынтығы бірдеңе өзгергеннен кейін байланыстардың жұмыс істейтінін дәлелдейді. Әр қабат қалған екеуі ұстай алмайтынды ұстайды.

Sandbox әдетте бермейтін сценарийлер

Бірінші тестті жазбас бұрын оларды жазып алыңыз. Sandbox олардың бір-екеуін арнайы тест мәнімен имитациялай алады; көбі онда жай ғана жоқ.

СценарийПродакшн не істейдіҚалай қамту керек
Баға іздеу мен брондау арасында өзгередіБрондау басқа сомамен өтеді немесе көрсетуге тиіс баға өзгерісі қатесімен құлайдыФикстура жұбы: сомасы басқа іздеу және брондау жауабы; саяхатшыдан қайта сұралатынын, үнсіз ақша алынбайтынын тексеріңіз
Қолжетімділік пен брондау арасында сатылып бітедіҰсынылған нөмір немесе тариф класы ұстап қалмақ болғанда жоқ болып шығадыЖеткізушінің нақты «сатылып бітті» қатесінің фикстурасы; саяхатшы қате бетіне емес, нәтижелерге қайтатынын тексеріңіз
Брондау шақыруындағы timeoutЖеткізуші броньды жасаған да, жасамаған да болуы мүмкінСұраныс жіберілгеннен кейін timeout енгізіңіз; кез келген қайталаудан бұрын брондау мәртебесі сұралатынын тексеріңіз
Қайталап жіберуҚос басу немесе клиенттің қайталауы екі брондау жасайдыБір броньды бір idempotency key-мен екі рет жіберіңіз; дәл біреуі бар екенін тексеріңіз
Билет жазылғаннан кейін кесте өзгерісіСатқан рейсіңіз енді басқа уақытта немесе басқа рейс нөмірімен ұшадыӨзгертілген маршрут фикстурасы; өзгерістің клиентті жүргізетін адамға жететінін тексеріңіз
Бірнеше қызметті брондаудағы ішінара сәттілікРейс расталады, қонақүй расталмайдыАралас фикстура; жүйе нақты не расталғанын жазып, адамға хабарлайтынын тексеріңіз
Жүктеме астындағы throttlingRate limit жауаптары, содан кейін баяу жауаптарЖазылған throttling жауабын қайта ойнатыңыз; backoff-ты және іздеудің қате бермей, баяулайтынын тексеріңіз

Өз стегіңіз үшін соңғы бағанмен келіспеуіңіз мүмкін. Оқасы жоқ. Маңыздысы — әр жолдың иесі мен ассерциясы болсын, өйткені олардың әрқайсысы ерте ме, кеш пе басыңызға түседі.

Фикстураларды ойдан шығарылған емес, нақты жауаптардан құрыңыз

Туристік интеграциядағы ең пайдалы әдет — сізді таң қалдырған жауаптарды сақтау. Қолмен жазылған mock деректер жеткізуші не жібереді деп ойлайтыныңызды көрсетеді; жазылған жауап ол шынымен не жібергенін көрсетеді — құжаттамада ешқашан бос болмайды делінген бос өрістерді, сіз сұрамаған валютадағы бағаны және сәтті мәртебемен келетін қатені қоса алғанда.

Жұмыс істейтін тәртіп:

  • Шекарада жазыңыз. Жеткізуші шақыруларының шикі сұраныс және жауап денелерін продакшн емес ортада, ал құпиялылық ережелеріңіз рұқсат етсе, продакшнда трафиктің іріктелген бөлігі үшін логтаңыз.
  • Сақтамас бұрын тазалаңыз. Жолаушылардың аты-жөні, паспорт нөмірлері, e-mail, телефондар және төлем сілтемелері фикстура репозиторийге түспес бұрын алынады. Оларды анық жалған мәндермен ауыстырыңыз, сонда ешкім фикстураны нақты брондаумен шатастырмайды.
  • Фикстураларды мінез-құлқына қарай атаңыз. hotel-book-price-increased.json келесі әзірлеушіге оның не үшін бар екенін айтады; response-17.json айтпайды.
  • Ұсқынсыздарын мәңгі сақтаңыз. Бір жексенбіде іздеуді құлатқан бұзылған жауап — сіздегі ең құнды файл. Оның орны — әр commit сайын іске қосылатын тест.

Содан кейін осы фикстураларға контракт тестерін жазыңыз: парсер, ішкі модельдерге mapping, қателерді жіктеу. Жеткізуші өрістің атын өзгертіп, контракт тесті құласа, бұл туралы клиенттен емес, CI-дан білесіз. Жіктеу жағы брондау жүйесі API қателерін өңдеу туралы мақаламызда толығырақ қаралған.

Ақша ағындарын ақша жұмсамай тестілеу

Мұнда sandbox ең аз көмектеседі, өйткені ақша ағындары — дәл тест ортасы нақтысынан ерекшеленетін жер. Нақты билет жазу, картадан нақты ақша алу және жеткізушінің нақты шот-фактурасы — ең көп дұрыс жасауыңыз керек және тірі жаттықтыра алатыныңыз ең аз нәрселер.

Мәселені бөліңіз. Баға математикасы — таза логика, оны офлайн толық тексеруге болады: жазылған тарифтерді алып, үстеме баға ережелерін, валюта айырбасын және дөңгелектеуді қолданыңыз да, саяхатшы көретін қорытынды соманы тексеріңіз. Мұны ыңғайсыз жағдайлар үшін жасаңыз — бір валютадағы тарифті басқа валютада сату, бір өнімде пайыз, екіншісінде тұрақты сома болатын үстеме, балалар тарифі, көрсету мен төлем арасында өзгеше дөңгелектеу. Бірнеше теңгеге қате сома бәрібір қате, және ол әр брондауда қате.

Төлем айналасындағы күй ауысулары — екінші жартысы. Оларды анық модельдеңіз — бағаланған, ұсталған, төленген, расталған, билет жазылған, бас тартылған, қайтарылған — және әр ауысудың дәл бір себебі бар екенін тексеріңіз. Ең қымбат багты ұстайтын тест — жеткізуші растамаған брондау үшін төлем алуға болмайтынын және төлем жазбасы жоқ расталған брондау болуы мүмкін еместігін бекітетін тест.

Соңында тест жүрісінің нақты билет жазуға жетуін мүмкін емес етіңіз. Ықтималдығы аз емес — мүмкін емес. Продакшн тіркелгі деректері жүктелгенде жиынтықты іске қосудан бас тартатын іске қосу тексерісі бір жолға тұрады және интеграция командасы бастан өткізуі мүмкін ең жаман таңның алдын алады.

Қателессеңіз бұл сізге қаншаға түседі

Туристік интеграцияда өткізіп алынған сценарий сирек қате ретінде көрінеді. Ол дұрыс сияқты көрінетін брондау ретінде көрінеді. Ешкім сұрамаған және біреу мерзімге дейін жоюы тиіс қайталанған билет. Агенттік енді өз есебінен көтеруге мәжбүр бағамен расталған қонақүй. Жүйе қайталаған timeout-ты брондау — жеткізуші екі нөмірді ұстап, екеуіне де шот жазады. Агенттік арқылы сатылған әуе билеті үшін жазылған мен сатылғанның арасындағы сәйкессіздік кейін ADM ретінде қайтып оралуы мүмкін — сол сатудың маржасы әлдеқашан жұмсалғаннан кейін.

Бұл шығындар retry циклін жазған әзірлеушіге емес, сапарды сатқан бизнеске түседі. Оларды қолдау тикеттері арқылы бір-бірлеп үйренудің орнына іске қосуға дейін тексерудің бүкіл дәлелі осы.

Әр жеткізуші өзгерісінен кейін нені smoke-тестілеу керек

Жеткізушілер нәрселерді өзгертеді: жаңа API нұсқасы, жаңа endpoint, ауыстырылған тіркелгі деректері, басқаша контент mapping. Сіздің кодыңыз мүлде өзгермеген болуы мүмкін. Бәрібір бұл тізімді өзгерген жеткізушімен сөйлесетін ортада іске қосыңыз:

  1. Сол жеткізушіден сататын әр өнім үшін нәтиже қайтаратынын білетін бағыт немесе қала бойынша бір іздеу.
  2. Ешқайсысын үнсіз тастамай әр нәтижені парсеңіз; өз санағыңызды шикі жауаптағымен салыстырыңыз.
  3. Бір нәтиженің бағасын басынан аяғына дейін есептеп, көрсетілген соманы шикі тарифтен өзіңіз есептегенмен салыстырыңыз.
  4. Тест ортасында брондау жасап, оның мәртебесін қайта оқыңыз және сақтайтын әр өрісті салыстырыңыз.
  5. Оны жойып, жоюдың өз жазбаларыңызда да, жеткізуші жағында да көрінетінін растаңыз.
  6. Сақталған ұсқынсыз фикстураларыңызды жаңа парсерден өткізіңіз.
  7. Timeout пен rate limit әлі де сіз шешкен мінез-құлыққа апаратынын тексеріңіз, өйткені жаңа нұсқа оларға басқаша жауап беруі мүмкін. Жауап уақыты ығысса, кідіріс туралы мақала оның қай бөлігін өзіңіз түзете алатыныңызды түсіндіреді.

Әр жолы іске қосуға жететіндей қысқа — мәні де сонда. Бір күн алатындықтан ешкім іске қоспайтын smoke-тест smoke-тест емес.

Sandbox-тың орны

Мұның ешқайсысы sandbox-ты пайдасыз етпейді. Оны адал етеді: фикстуралар мен тірі тексерулер ол жете алмайтын бөліктерді өз мойнына алмас бұрын схеманы үйреніп, сұраныстардың дұрыстығын растайтын орын. Платформаның әуе билеттері мен қонақүй API-лерін бағалап жатсаңыз, қолжетімділік self-service кілтпен емес, әңгімеден басталады — осы тест жоспарын сол әңгімеге алып келіңіз және жоғарыдағы кестенің әр жолы қалай қамтылатынын сұраңыз. Жауаптар сізге API туралы оның құжаттамасынан көбірек айтады.

Tekravel редакциясы

Туристік технологиялар бөлімі

Tekravel-тің туристік технологиялар бөлімі сала мамандарына жазады: агенттік иелеріне, консолидаторларға және оларды интеграциялайтын әзірлеушілерге. Әрбір мақала жарияланбас бұрын өзі сипаттайтын платформада тексеріледі.