Туристік API салыстыру: жеткізушіні емес, осьтерді бағалаңыз

Үш қойындыда үш жеткізушінің презентациясы ашық тұр. Әрқайсысында әуекомпаниялардың ұзын тізімі бар слайд, қонақүйлер саны жазылған слайд, sandbox, REST пен JSON және қолдау қызметінің поштасы бар. Сіз кесте құрасыз, әр ұяшыққа белгі қоясыз, ал кесте тең аяқталады. Функциялар тізімі ретінде жүргізілген туристік API салыстыру әдетте осылай бітеді және бұл — қате соңы. Келесі жылыңызды шешетін айырмашылықтар іске қосылғаннан кейін ғана көрінеді: жеткізушіде сәтті өтіп, сіз жақта timeout-қа ұшыраған брондауда; ешкім өңдей алмайтын ақша қайтаруда; тізімде тұрған, бірақ осы бағыт арқылы билетін шығару мүмкін емес әуекомпанияда.
Бұл мақала сол шешімді қабылдап, кейін оны қорғауға тиіс әзірлеушіге немесе техникалық жетекшіге арналған. Ол жеткізушілерді рейтингке салмайды. Ол сізге салыстыру осьтерін, уақытын ақауларға жұмсайтын сынақ жоспарын және алдыңыздағы тарап жеткізуші ме, әлде біреудің жеткізушісін қайта сатушы ма екенін тез көрсететін қысқа сұрақтарды береді.
Функциялар тізімі неге әрдайым тең аяқталады
Тізім қандай да бір мүмкіндіктің бар-жоғын сұрайды. Кез келген дерлік туристік API кез келген дерлік жолға «иә» дей алады, өйткені жолдар маркетинг беті деңгейінде жазылған: іздеу, баға, брондау, бас тарту, билет шығару, webhook, sandbox. Оларды ажырататын сұрақ cancel бар ма деген емес, оны ұшуға он екі сағат қалғанда, айыппұлы бар тарифте, контенті үшінші тараптан келген бағыт арқылы билеті шығарылған брондауда шақырғанда не болатыны. Тізімде бұған баған жоқ.
Екінші мәселе де бар. Тізімді әдетте жеткізушінің өзі толтырады. Сіз оның өзі туралы жазғанын бағалап отырсыз.
Жеткізушілерге емес, осьтерге негізделген туристік API салыстыру
«Жеткізуші × функция» торын сынақ кезеңінде жиналған дәлелдер бойынша өзіңіз бағалайтын осьтермен алмастырыңыз. Төмендегі кестені біз қолданар едік. Жолдарға басқаша салмақ беруіңізге болады — тек қонақүй сататын бизнес үшін билет шығару маңыздылығы азырақ — және оны қабылдамас бұрын онымен дауласып көрген жөн.
| Ось | Тізім не сұрайды | Шын мәнінде нені анықтау керек | Әлсіз жауап қалай естіледі |
|---|---|---|---|
| Қамту | Қанша әуекомпания мен қонақүй? | Сіздің нарықтарыңызда осы API арқылы олардың қаншасын іздеуге, брондауға ЖӘНЕ билетін шығаруға не растауға болады | Бөлінбеген бір үлкен сан |
| Тереңдік | Бас тарту endpoint-і бар ма? | Әр контент көзі бойынша брондаудан кейінгі қай әрекеттер автоматтандырылған: void, ақша қайтару, қайта шығару, атын түзету, қосымша қызметтер | «Мұнымен операциялық командамыз айналысады» |
| Бағаның дұрыстығы | Баға нақты уақытта ма? | Брондау кезіндегі баға іздеудегіден қаншалықты жиі өзгеше болады және API бұл туралы қалай хабарлайды | «Бағалар әрдайым тірі» |
| Қателердің мағынасы | Қателер құжатталған ба? | Қате тек бірдеңе болмағанын емес, брондаудың қандай күйде екенін айта ма | Кез келген ақауға бір жалпы код |
| Идемпотенттілік | — | Қайталанған брондау шақыруы екінші брондау жасай ала ма | Үнсіздік, сосын «мұндайды көрмеппіз» |
| Келісімшарт бойынша жеткізуші | — | Билет кімнің келісімшарты, кімнің IATA нөмірі, кімнің BSP-і арқылы өтеді | «Біз барлық ірі GDS-термен жұмыс істейміз» |
| Қолжетімділік пен қолдау | Sandbox бар ма? | Тірі PNR тұрып қалғанда кім жауап береді және қаншалықты тез | Өтінім формасы және аты-жөні бар бірде-бір байланыс адамы жоқ |
Бұл жолдардың екеуіне тізімде мүлде сұрақ жоқ. Бұл кездейсоқ емес: іс бұзылғанда ең қымбатқа түсетін және сату презентациясы өз еркімен ең аз айтатын жолдар дәл осылар.
Қамту — тереңдік емес
Әуекомпаниялар тізімі — кез келген презентациядағы ең адастыратын слайд. Бірнеше жүз тасымалдаушыдан тұратын тізім әртүрлі нәрсені білдіруі мүмкін, ал соның біреуі ғана сізге керегі.
Бұл тасымалдаушылардың бір бөлігі GDS арқылы келеді және оларды басынан аяғына дейін брондап, билетін шығаруға болады. Бір бөлігі NDC қосылымдары арқылы келеді: мұнда іздеу жақсы жұмыс істеуі мүмкін, бірақ брондаудан кейінгі қызмет — өзгерістер, ішінара ақша қайтару, багаж қосу — сол әуекомпания үшін әлі де қолмен жүруі мүмкін. Тағы бір бөлігі — контенті басқа қайта сатушыдан жиналатын лоукостер: оларды көрсете аласыз, кейде брондай аласыз, содан соң билет сіз бақыламайтын жолмен, клиентке уәде бере алмайтын мерзімде келеді. Ал кейбірі бір кезде қандай да бір тариф іздеу жауабында көрінгені үшін ғана тізімде тұр.
Көрсете алатын, бірақ билетін шығара алмайтын тасымалдаушы — қамту емес. Бөлшек өнім үшін бұл оның жоқтығынан да жаман: клиент оны таңдайды, төлейді, сосын күтеді.
Қонақүйлердің пішіні де сондай, тек сөздері басқа. Нысандар санына жеткізуші сәйкестендірген және сәйкестендірмеген қонақүйлер; өткен аптада кэшке жазылған статикалық бағалар мен тірі қолжетімділік қатар; release мерзімі бар аллотмент нөмірлері мен еркін сату қоры кіреді. Сіз сататын қалаларда тірі брондауға болатын нысандар санын сұраңыз және олардың өз жеткізушілері арасындағы қайталанатын жазбалар қалай біріктірілетінін біліңіз: бір қонақүйдің үш бағамен үш рет шығуы — күтіп тұрған қолдау өтінімі.
Практикалық тексеру тар. Көлеміңіздің басым бөлігін беретін жиырма бағыт пен жиырма қонақүй қаласын жазып шығыңыз — мысалы, Алматы–Дубай, Астана–Анталья, Дубай мен Шарм-эш-Шейхтегі қонақүйлер — және жеткізушіден дәл соларды sandbox-та басынан аяғына дейін жұмыс істеп тұрған күйде көрсетуін сұраңыз: іздеу, баға, брондау, билет шығару не растау, бас тарту. Тереңдігі бар жеткізуші мұны артық сөзсіз жасайды. Тек слайды барлар слайд туралы айта бастайды.
Сынақ кезеңінде нені тексеру керек: бақытты жолдарды емес, қате жолдарын
Кез келген sandbox тыныш бағытта эконом класындағы бір жақты билетті сәтті брондайды. Ол дәл осыны көрсету үшін жасалған. Өндірістік трафигіңіз өмірінің едәуір бөлігін басқа жолдарда өткізеді, ал сынақ кезеңі — оларды көрудің жалғыз арзан сәті.
Сынақта осы тізімнен өтіңіз және API не қайтарғанын кейін шын мәнінде дұрыс болып шыққанмен қатар жазып отырыңыз:
- Іздеу мен брондау арасында бағаның өзгеруі. Брондау шақыруы сәтсіз бола ма, жаңа бағамен өте ме, әлде растауды сұрайтын жеке жауап қайтара ма? Интерфейсіңіз хабарлама мәтінін талдамай-ақ бұл жағдайларды ажырата ала ма?
- Мерзімі өткен ұсыныс. Іздеңіз, жеткізуші айтқан ұсыныс мерзімінен ұзағырақ күтіңіз, сосын брондаңыз. Мерзімнің өтуі жеке қате ме, әлде «жеткізуші қолжетімсіз» дегенмен бірдей қате ме?
- Брондау сәтінде сатылып кеткен. Баға мен брондау арасында жоғалған қор. Брондау қандай күйде және төлем бұғаты босатыла ма?
- Timeout-тан кейін қайталау. Брондау сұрауын жіберіңіз, жауап келмей тұрып байланысты үзіңіз және оны қайта жіберіңіз. Енді сізде бір PNR бар ма, әлде екеу ме? Осы бір тест жеткізуші туралы сынақтың қалған бөлігінің бәрінен көп нәрсе айтады.
- Брондау жасалды, билет шықпады. API бар, бірақ билеті шығарылмаған PNR туралы хабарлай ала ма және билет шығарудың соңғы мерзімін айта ма?
- Ішінара ақау. Бірнеше нөмірге арналған қонақүй сұрауы: біреуі расталады, екіншісі жоқ. Барып-қайту ұшуы: сегменттер әртүрлі көздерден келеді.
- Тегін терезеден тыс бас тарту. Айыппұл растауға дейін айтыла ма, әлде оны шот-фактурадан көресіз бе?
- Жеткізушінің істен шығуы. Жеткізушіден мұны қалай модельдеуге болатынын сұраңыз. Білмесе, оның клиенттері жүйенің сол кезде өзін қалай ұстайтынын қалай білгенін сұраңыз.
Әр жағдайда екі нәрсені бағалайсыз. Біріншісі: API брондаудың күйі туралы сізге шындықты айта ма? Екіншісі: кодыңыз еркін мәтінді оқитын адамсыз осы шындық негізінде әрекет ете ала ма? Анық сәтсіз болатын API-мен өмір сүру екіұшты сәтті болатын API-мен өмір сүруден оңай.
Ұшу жағы туралы толығырақ авиабилет брондау API құжаттамасы айтпайтын нәрселер туралы мақалада, ал баяу қонақүй жеткізушілеріне арналған клиентті жобалау туралы қонақүй қолжетімділігі туралы мақалада жаздық. Екеуі де сынақ жоспарына жақсы толықтыру.
Жұқа агрегаторды әшкерелейтін сұрақтар
Агрегаторда жаман ештеңе жоқ. Туристік контенттің көбі сатушылардың көбіне дәл солардың бірі арқылы жетеді. Қауіп — жұқа агрегаторда: басқа қабаттың API-ін қайта сататын, үстіне маржа қосатын, бірақ жеткізушімен келісімшартқа да, операциялық бөлімге де ие емес қабат. Бірдеңе бұзылса, жауап екі компания жоғары барып, қайта оралуы керек.
Бес сұрақ мұны тез анықтайды:
- Бұл брондау бойынша келісімшарт жеткізушісі кім? Ол әуекомпаниямен немесе қонақүймен кімнің келісімшартына сүйенеді?
- Билет кімнің IATA нөмірі және кімнің BSP-і арқылы өтеді? Жауап «серіктестікі» болса, тариф ережесі бұзылғанда ADM-ді кім алатынын сұраңыз.
- Мен cancel шақырғанда сіз жақта не болады? Жеткізушіге автоматты шақыру ма, әлде адам алатын кезек пе?
- Жоғарғы көздің қатесін көре аламын ба? Жұқа қабат әдетте кез келген ақауды бір кодқа сығып тастайды, өйткені өзі алатын қателерді толық түсінбейді.
- Тұрып қалған тірі брондау бойынша кімге қоңырау шаламын және олар кімге шалады? Буындарды санаңыз.
Бұл жауаптардың ешқайсысы өздігінен дисквалификация жасамайды. Келісімшартта дебет-нотаны кім көтеретіні анық жазылса, серіктестің IATA нөмірі де жарай береді. Маңыздысы — жеткізушінің нақты әрі тез жауап беруі. Бүгінгі бұлыңғыр жауаптар — кейін, өндірісте, нашар уақытта алатын жауаптарыңыз.
Қате таңдау сізге қаншаға түседі
Интеграция — арзан бөлік. Қымбат бөліктері кейін келеді және ешбір сметада көрінбейді.
Қос брондау қатесі — екі рет ақша алынған клиент және қолмен тауып, бас тартуға тура келетін PNR, мүмкін тегін void терезесі жабылғаннан кейін. Көзде сәтті өтіп, сіз жақта қате ретінде жазылған брондау — ұсталып тұрған, сосын автоматты түрде жойылған орын және брондағанына сенетін клиент. Көрсетілген, бірақ билетін шығару мүмкін болмаған тасымалдаушы — ақша қайтару, кешірім және енді оралмайтын клиент. Жеткізуші бағыты бұзған тариф ережесі үшін ADM билет иесіне келеді — бұл сіз бе, жоқ па, алдын ала анықтап алыңыз.
Сонымен қатар ауысу шығыны бар. Сіз сіңірген әр жеткізуші ерекшелігі — екі мағынасы бар статус коды, кейде жол болатын өріс — деректер моделіңізге түседі. Екі жылдан кейін API таңдауы енді бір спринтте ауыстыруға болатын интеграция емес; бұл сіздің брондаулар кестеңіздің пішіні. Қазір мұқият салыстырудың шынайы себебі осы.
Біздің API осы әдіске қалай сәйкес келеді
Біз авиабилет пен қонақүй API-лерін ұсынамыз. Қолжетімділік self-service кілтпен емес, әңгімемен басталады; кейбір әзірлеушілер мұны баяу деп санайды. Себебі жоғарыдағы сұрақтар дәл осы әңгімеде екі жаққа да қойылады — сізге қай бағыттар мен қалалар керек, қай контенттің билетін шынымен шығара не растай аласыз, брондаудан кейін не үшін кім жауап береді. Салыстыру жүргізіп жатсаңыз, осы тізімді өзіңізбен бірге алып келіңіз. Бұл әңгіме туристік API бетінде басталады.
Не таңдасаңыз да, презентацияға қарап емес, сынақ журналына қарап таңдаңыз. Презентация жеткізушінің кім болғысы келетінін айтады. Қате жолдары оның кім екенін айтады.