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

Қонақүй мен әуе билетін брондау API: бір сапар, екі бронь

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

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

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

Екі жарты бірдей қимылдамайды

Екеуі де баға мен сілтеме нөмірімен JSON ретінде келеді, сондықтан желіде ұқсас көрінеді. Сілтеме қолыңызға тиген соң олар беретін уәде ұқсамайды.

СұрақҰшақ билетіҚонақүй
Брондаудан кейін қолыңызда не барӘлі билет емес резерв (PNR)Әдетте сіз сатқан нәрсенің өзі болып табылатын растау
Баға қанша уақыт жарамдыБрондау кезінде тарифтің қайта бағалануына дейін, ол іздеудегіден өзгеше болуы мүмкінТариф мерзімі біткенше; тариф бос орынды тексеру мен брондау арасында өзгеруі мүмкін
Растауды не бередіБилетті шығару, көбіне уақыт шектеуіменЖеткізушінің растауы, кейде бірден, кейде күтуде
Қалай кері қайтарыладыЕрте ұсталса void, әйтпесе тариф ережесі бойынша қайтару, жиі айыппұлменТарифтің өз саясаты бойынша бас тарту; көп тарифте белгілі уақытқа дейін тегін
Соманы кейін не өзгертедіТариф, салықтар, кейде тариф валютасыНысанда төленетін салықтар мен алымдар, тамақтану түрі, нақты берілген бөлме

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

Қайсысын алдымен брондау керек?

Мұның дизайн шешімі екенін ешкім айтпайды, бірақ ақаудың қанша тұратынын дәл сол анықтайды.

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

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

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

Бір сапар, екі бронь

Төзімді пішін — әрқайсысының өз сілтемесі, күйі және шарттары бар екі брондың иесі болатын сапар жазбасы. Клиент бір жиынтық көреді. Деректер қорыңыз екі жол көреді, ал жиынтық — жеткізушіде бар нәрсе емес, өзіңіз есептейтін қосынды.

Екі күйді бөлек ұстаңыз. Қонақүй үшін «расталды» мен ұшақ үшін «билет шығарылды» бірдей күй емес, ал оларды жайпайтын жалғыз күй бағаны ерте ме, кеш пе жартылай брондалған сапардың үстіне «брондалды» деп жазады.

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

Бұл платформа қай жерде тұр

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

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

Қателіктің құны

Қымбат нұсқа — үнсізі. Клиентке қалаға билет шығарылған, бөлме жоқ болып кеткен, ал бірінші хабарды түнде әуежайдан келген хабарламадан аласыз. Арзанырақ, бірақ бәрібір нақты: бір сенімді жиынтық көрсетіп, баға тексерілгеннен кейін клиент келіспеген екінші санды шығаратын төлем; ұшақты қайтарып, қонақүйді ұмытатын қайтару; жеткізуші басқаша айтқанда «брондалды» деп тұрған күй.

Бұлардың ешқайсысы айлакер шешімді қажет етпейді. Сапар нақты нысан болуы, рет біреу жазып қойған шешім болуы және екеуінің бірі расталар алдындағы соңғы сәтте екі баға қайта тексерілуі керек. Мұны бір рет құрыңыз, сонда төлем беті тапсырма сұрағандай қарапайым көрінеді.

Tekravel редакциясы

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

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