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

Авиабилеттерді брондау API интеграциясы: құжаттамада не жоқ

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

Тақтадағы тикетте «авиарейстерді қосу» деп жазылған. Сіз бұған дейін төлем интеграциясын, жеткізу құнын есептеуді, мүмкін карталарды да қосқансыз, сондықтан басыңызда айқын модель бар: іздеу, нәтижелерді көрсету, картадан ақша алу, бітті. Сосын алғашқы нақты брондау нәтижелер бетіндегіден басқа бағамен қайтады, екіншісі тайм-аутқа түсіп, клиенттің орны бар-жоғын ешкім айта алмайды, ал операциялық бөлімнен брондау бар, бірақ билет неге жоқ деп сұрайды. Сырттан қарағанда авиабилеттерді брондау API интеграциясы интернет-дүкеннің кәдімгі чекаутына ұқсайды. Ал іс жүзінде бұл REST пайда болғаннан әлдеқайда бұрын жасалған жүйелермен жүретін таратылған транзакция, және тосын жағдайлардың көбі осы алшақтықтан туады.

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

Авиабилеттерді брондау API интеграциясындағы шақырулар реті

Әдістерін қалай атаса да, кез келген дерлік авиа-API бірдей төрт қадамнан өтеді. Олардың арасындағы шекараны дұрыс жүргізу — жұмыстың негізгі бөлігі.

ҚадамНе аласызНені сақтау керекҚайда қате кетеді
ІздеуБағасы және ашық емес ұсыныс не тариф кілті бар маршруттарҰзақ сақталатын ештеңе — нәтижелер тез ескіредіБағаны түпкілікті деп қабылдайсыз; кілттің мерзімі төлемге жеткенше өтіп кетеді
Баға / тексеруРасталған баға, тариф ережелері, багаж, кейде жолаушының міндетті өрістеріТексерілген ұсыныс және оның жарамдылық мерзіміБаға өзгерді; класс сатылып кетті; ережелер көрсетілгеннен өзгеше
БрондауБрондау — PNR — record locator және билет жазу дедлайныменӨз брондау нөміріңіз, локатор, дедлайн, жіберілген жолаушы деректерінің дәл нұсқасыЖауапсыз тайм-аут; қайталанған PNR; аты-жөндер қабылданбады
Билет жазуЖазылған электрондық билет нөмірлері; ақша нақ осы жерде шынымен міндеттеледіӘр билет нөмірі — тиесілі жолаушы мен сегментке байланғанІшінара жазу; дедлайн өтіп кеткендіктен әуекомпания брондауды жойды

Ең көп дау тудыратыны — үшінші жол, өйткені көп API брондау мен билет жазуды бір шақырумен жасауға мүмкіндік береді. Қаласаңыз, пайдаланыңыз. Бірақ әуекомпания әлемінде бұлар бәрібір екі бөлек нәрсе: PNR билетсіз өмір сүре алады, ал билет PNR жасалғаннан кейін де сәтсіз болуы мүмкін. Біріктірілген эндпоинт біреуі сәтті өтіп, екіншісі өтпеген сәтті жай ғана жасырады, сондықтан деректер моделіңізде бұл күйге бәрібір орын болуы керек.

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

Іздегендегі баға неге брондағандағы бағаға сәйкес келмейді

Веб-әзірлеушілер каталог күтеді. Әуекомпанияның орын қоры каталог емес. Рейс брондау кластарымен сатылады, әрқайсысы — белгілі бір тарифтегі орындар себеті, және рейс толған сайын әуекомпания бұл себеттерді үздіксіз ашып-жауып отырады. Іздеу нәтижелері сәл артта қалуы мүмкін қолжетімділік деректерінен жылдам құрастырылады; пайдаланушы екі төлқұжатты енгізіп болғанша, сол рейстегі ең арзан себет жабылып қалуы мүмкін. Баға қадамы іске қосылғанда ол қайта сұрайды, ал адал жауап кейде қымбатырақ болып шығады.

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

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

Идемпотенттілік және брондау кезіндегі тайм-аут нені білдіреді

Бұл бөлімді екі рет оқыған жөн.

Брондау шақыруы тайм-аутпен аяқталғанда, не болғанын білмейсіз. Сұрау мүлде жетпеуі мүмкін. Жетіп, қатемен аяқталуы мүмкін. Немесе — ең ауыр жағдай — жетті, жеткізуші әуекомпанияда PNR жасады, ал жауап сізге қайтар жолда жоғалып кетті. Сіздің кодыңыз үшін үшеуі де бірдей көрінеді. Әуекомпания үшін үшіншісі — клиентіңіздің атына орындарды ұстап тұрған тірі брондау.

Басқа интеграциялардан қалған рефлекс — сұрауды қайта жіберу. Мұнда соқыр қайталау сол жолаушыларға сол рейсте екінші PNR жасауы мүмкін. Әуекомпаниялар қайталанған брондауды ережені бұзу деп санайды; тасымалдаушыға және агенттіктің келісімдеріне қарай салдары бір немесе екі брондауды автоматты түрде жоюдан бастап, оларды рәсімдеген тарапқа жіберілетін дебеттік ескертпеге — ADM-ге дейін жетеді. Оны алған агенттік сіздің жүйеңіз неге екі рет брондағанын білгісі келеді.

Не жұмыс істейді — шамамен мына ретпен:

  • Сыртқы шақыруға дейін өз брондау нөміріңізді жасаңыз, оны сақтаңыз және API клиент референсін қабылдайтын жердің бәрінде сұраумен бірге жіберіңіз. API идемпотенттілік кілтін (idempotency key) қолдаса, пайдаланыңыз; қолдамаса да, кейін брондауды іздеп табуға мүмкіндік беретін нақ сіздің нөміріңіз.
  • Белгісіз күйді анық модельдеңіз. Күтуде, расталды, сәтсіз — және белгісіз. Тайм-аут брондауды «сәтсіз» емес, «белгісіз» күйіне ауыстырады.
  • Белгісізді қайталау арқылы емес, сұрау арқылы анықтаңыз. Қайта әрекет ету-етпеуді шешпес бұрын брондауды өз нөміріңіз бойынша алыңыз немесе сол жолаушылардың соңғы брондауларын тізімдеңіз.
  • Салыстыру тапсырмасын іске қосыңыз: ол әлі «белгісіз» күйдегінің бәрін шолып, жеткізуші хабарлаған деректермен салыстырады, ал шеше алмағанын болжап отырмай, адамға арналған кезекке жібереді.

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

Веб-әзірлеушілерді таң қалдыратын авиация ұғымдары

Бұлардың ешқайсысы қиын емес. Әрқайсысы біреудің бір аптасын жеп кетті — тек оның бар екенін білмегендіктен.

PNR — билет емес

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

Аты-жөнді өзгерту дерлік мүмкін емес

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

Жолаушы түрі — сәндік емес, бағаға әсер етеді

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

Уақыт жергілікті, ал сегмент — leg емес

Ұшу және қону уақыты әр әуежайдың жергілікті уақытымен беріледі. Оларды көрсету үшін пайдаланушының уақыт белдеуіне ауыстырмаңыз және ығысуларды ескермей, жай азайту арқылы ұзақтықты есептемеңіз. Сапар сегменттерден тұрады; техникалық аялдамасы бар сегментте бірнеше leg болады. Интерфейс пен деректеріңіз «аялдама» деп осының қайсысын атайтынына бірдей келісуі керек.

Сатылымнан кейін де өзгерістер болады

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

Void — қайтару емес

Билет жазылғаннан кейін көп ұзамай әдетте билетті ешқашан болмағандай жоюға (void) болатын уақыт терезесі болады. Ол терезеден кейін тек тариф ережелері бойынша қайтару ғана мүмкін, және ол айыппұлмен өтуі немесе мүлде ештеңе қайтармауы мүмкін. Терезе мен оның ережелері жеткізушіге және билет жазу келісіміне байланысты; «Болдырмау» батырмасын жасамас бұрын оларды оқып шығыңыз.

Қате қанша тұрады

Авиа интеграциядағы ақаулар ерекше түрде қымбат: олар логтарға емес, адамдарға түседі. Қайталанған брондау әуекомпанияға телефон соғуға және, мүмкін, агенттік шотына ескертпеге айналады. Ақшасы алынған, бірақ билеті жоқ клиент — қайтарым, шағым және чарджбэк қаупі. Сәтті төлемсіз жазылған билет — біреу жабуы тиіс әуекомпания алдындағы қарыз. Ешкім өңдемеген кесте өзгерісі — ертерек ұшып кеткен рейске әуежайға келген жолаушы.

Мұның ешқайсысы «бақытты жол» тестінде көрінбейді. Алдымен сәтсіз сценарийлерді жазыңыз: брондау кезіндегі тайм-аут, көтерілген баға, PNR-ден кейін жазылмай қалған билет, сәтті төлемнен кейінгі void. Олар өңделген болса, бақытты жол — ең оңай бөлігі.

Авиа-API-мен тестілеу

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

Мүлде интеграция жасау керек пе — бұл бөлек сұрақ. Егер сізге шын мәнінде өз жүйеңіздегі шикі орын қоры емес, витрина керек болса, артықшылықтар мен кемшіліктер white label пен өз брондау жүйесін құру туралы материалда талданған, ал дәл сол пайымдау субагенттерге арналған B2B порталына да қатысты. Ал орын қорын өз кодыңызда ұстағыңыз келсе, бұл платформа авиабилеттер мен қонақүйлерге арналған API ұсынады, және қолжетімділік өздігінен алынатын кілттен емес, сіздің сценарийіңіз туралы әңгімеден басталады — жоғарыдағы сұрақтардың әрқайсысын қоюға да дәл осы сәт.

Tekravel редакциясы

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

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