Брондау жүйесі API қателерін өңдеу: ақшаға түсетін үш ақау

Қолдау билеті бейсенбі кешінде келеді. Клиент төледі, бет айналып тұрды да, жалпы қате көрсетті. Картадан ақша алынды. Логтарыңызда жеткізушіге жіберілген, жауап алмаған POST көрінеді. Әуе компаниясы орынды ұстап тұрды ма? Ешкім айта алмайды, ал клиент күтіп отыр. Жақсы брондау жүйесі API қателерін өңдеу негізінен осындай жағдайға ешқашан түспеу, ең болмағанда түскенде не істеу керегін нақты білу жұмысы.
Интеграция нұсқаулықтарының көбі қателерді статус кодтарының каталогы ретінде қарастырады. Брондауда кодтар — ең оңай бөлік. Ақшаға түсетіні — сұрау сәтсіз көрінгенімен әлем бәрібір өзгерген, не сәтті көрінгенімен әлем өзгермеген шағын жағдайлар жиыны. Олардың үшеуі қалғанынан маңыздырақ.
Бірінші ақау: баға іздеу мен брондау арасында өзгерді
Іздеу нәтижелері — ұсыныс, келісімшарт емес. Тарифтер кэште сақталады, орындар жеткізуші сататын барлық арналар арасында ортақ, ал сіз 14:02-де көрсеткен сома бірнеше минуттан кейін ескіруі мүмкін. Жеткізуші бұл туралы брондауды құру қадамында хабарлайды: кейде «тариф өзгерді» деген айқын жауаппен, кейде әйтпесе сәтті жауаптың ішінде басқа жиынтықты үнсіз қайтарып.
Қауіптісі — екінші түрі. Кодыңыз растауды оқып, брондауды сақтап, клиенттен ол көрген соманы алса, айырма сіздің маржаңыздан, кейін ADM-нен шығады. Ереже қарапайым: жеткізуші растаған жиынтықты клиент қабылдаған жиынтықпен әр жолы, кодта, төлемді алудан бұрын салыстырыңыз.
Айырма болғанда не істеу оның үлкендігіне және оны кім көтеретініне байланысты. Валюталар арасындағы бірнеше тиындық дөңгелектеу — бір рет белгілейтін шектеу. Одан үлкені клиентке нақты қабылдау түймесі бар жаңа баға ретінде қайтарылады. Оны ешқашан автоматты түрде жұтпаңыз және автоматты түрде алмаңыз.
Екінші ақау: брондалды, бірақ билет берілмеді
PNR-дің болуы билеттің болуымен бірдей емес. Көптеген ағындар алдымен брондауды жасайды, ал электронды билетті бөлек қадамда береді, екеуінің арасында уақыт шегі болады. Төлем өтіп, билет беру сәтсіз болса, сізде клиенттің ақшасы және өз сағатымен біту алдындағы брондау қалады.
Ақау сирек шулы болады. Билет беру шақыруы қате немесе таймаут қайтарады, ал брондау базаңыз «төленді» деп атайтын күйде қалады, жеткізуші әлі «ұсталған» дейді. Осы кезде билет беру мерзімі жүріп жатады және қолдау кезегіңізден өзгеше, әуе компаниясы күтпейді.
Оны сәттілік не сәтсіздік нұсқасы ретінде емес, жеке күй ретінде өңдеңіз. Брондауға кемінде мына күйлер керек: жасалды, ұсталды, төлем алынды, билет беріліп жатыр, билет берілді, сәтсіз-әрі-қайтарылатын. «Төлем алынды, билет беріліп жатыр» — таймер керек күй: брондау онда тым ұзақ тұрса, тапсырма адамның байқауын күтпей, брондауды жеткізушіден қайта оқып, шешім қабылдауы тиіс. Жеткізушінің уақыт шегін білсеңіз, шешім арзан, себебі ол ақшаны қайтарғанға дейін қанша уақыт қауіпсіз қайталауға болатынын көрсетеді.
Үшінші ақау: нәтижесі белгісіз таймаут
Бұл — бейсенбі кешкі билет. Сұрауыңыз кетті; жауап келмеді; байланыс үзілді немесе шлюз бас тартты. Жеткізуші оны толық, жартылай немесе мүлде өңдемеген болуы мүмкін.
Азғыру — қайталау. Брондау құру шақыруын соқыр қайталамаңыз, себебі екінші әрекет екінші брондауды тудыруы мүмкін, ал телнұсқа — нақты шығын: екі орын ұсталған, мүмкін екі билет берілген, біріне байланысты қайтару дауы.
Қауіпсіз тәртіп: тоқта, оқы, сосын шеш. Клиенттік ағынды адал «брондауыңызды растап жатырмыз» күйімен тоқтатыңыз. Жеткізуші жағын шақыруға дейін өзіңіз жасаған сілтемемен брондауды іздеп оқыңыз (сондықтан алдымен өз клиенттік сілтемеңізді жасап, жеткізуші қабылдаса, оны жібересіз). Тек содан кейін шешіңіз: табылса, нақты күйден жалғастырыңыз; жеткізушінің өз өңдеу терезесінен кейін табылмаса, бір рет қауіпсіз қайталауға болады.
Жеткізуші сіздің сілтемеңіз бойынша іздеуге мүмкіндік бермесе, жолаушы аты, бағыт және күн бойынша тар терезеде іздеп, сәйкестікті табылған деп санаңыз. Ұсқынсыз, бірақ телнұсқадан әлдеқайда арзан.
Қарсы болуыңызға болатын шешім кестесі
| Не көресіз | Не білесіз | Не істейсіз | Не істемейсіз |
|---|---|---|---|
| Жеткізуші «тариф өзгерді» қайтарады | Ештеңе брондалмаған | Жаңа жиынтықты көрсетіп, келісім сұрап, құруды қайта іске қосу | Өтеді деген үмітпен ескі бағамен қайта іске қосу |
| Сәтті, бірақ жиынтық клиент қабылдағаннан өзгеше | Жаңа бағамен брондау бар | Төлемді ұстап, клиенттен сұрап, бас тартса брондауды жою | Ескі соманы алып, айырманы жұту |
| Төлем алынды, билет беру шақыруы қате берді | PNR бар, билет күйі белгісіз | Брондауды қайта оқып, шектің ішінде қайталап, одан кейін қайтару | Брондауды сәтсіз деп белгілеп, PNR-ді ұмыту |
| Құру кезіндегі таймаут | Нәтиже белгісіз | Өз сілтемеңізбен іздеп, жалғастыру немесе бір рет қайталау | Дереу соқыр қайталау |
| Бас тарту кезіндегі таймаут | Сегмент үшін әлі жауап беруіңіз мүмкін | Клиентке бірдеңе айтпас бұрын күйді қайта оқу | Басу болғаны үшін «бас тартылды» көрсету |
Таласуға болатын бір жол: кейбір командалар клиентті тыныштандыру үшін билет берудің алғашқы қатесінде ақшаны қайтарады. Арзан билеттерде бұл ақталады, қымбаттарында жаман әдет, себебі бір минуттан кейін сақтап қалуға болатын тарифті жоғалтуыңыз мүмкін.
Қателесу сізге неге түседі
Әр ақаудың есебі әртүрлі. Өткізіп алынған баға өзгерісі — әсер еткен әр брондаудағы жоғалған маржа, көбіне тек салыстыру кезінде байқалады. Брондалды-бірақ-билет-жоқ жағдайы — мерзімі өткен брондаумен және картадан алынған ақшамен әуежайға келген клиент: бір мезгілде чарджбэк және беделге қатысты мәселе. Таймауттан кейінгі соқыр қайталау — қосарланған брондау, ал әуе компаниялары телнұсқаларды тексереді; олардың қайталанатын үлгісі ADM-ге түсетін нәрсе.
Мұның ешқайсысы экзотика емес. Бұл демоны демалыс күндері қалдыруға болатын жүйеден бөлетін көзге түспейтін құбыр жұмысы.
Салыстыру тапсырмасын қажет болғанға дейін құрыңыз
Үш ақаудың бәрі бірдей аяқталады: сіздің базаңыз бен жеткізуші базасы келіспейді. Сондықтан оларды салыстыратын тапсырманы бірінші оқиғадан кейін емес, бұрын жазыңыз. Түнгі іске қосу — минимум; өтпелі күйдегі барлық нәрсе үшін бірнеше минут сайын жақсырақ. Ол ұсталған, билет беріліп жатқан немесе белгісіз күйде тұрып қалған брондауларды тізімдейді, жеткізушіден не ойлайтынын сұрайды, содан кейін жазбаны түзетеді немесе дәлелдері қоса тіркелген билет ашады.
Брондау шақыруларының әр сұрауы мен жауабын, таймауттарды қоса, жіберген сілтемемен бірге сақтаңыз. Клиент алынған соманы даулағанда, сол лог — сіздің дәлеліңіз. Ол кідіріс туралы әңгімені де адал ұстайды: таймауттардың жойылатын қате емес, өмір шындығы екенін түсіну үшін API кідірісінде нені түзетуге болатынын және болмайтынын қараңыз.
Жеткізушімен байланысты қалай жалғау керегін әлі шешсеңіз, әуе билеттерін брондау API интеграциясы мақаласы осы мақала болжайтын шақырулар тәртібін қамтиды. Ал бұл күйлердің біздің әуе билеттері мен қонақүй API-лерімен қалай сәйкес келетінін талқылағыңыз келсе, қолжетімділік әңгімеден басталады: саяхат API беті.