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

Amadeus Self Service API баламасы: бір аптада көшу

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

Мұны сіз не сәтсіз health check-тен, не пайдаланушыдан білесіз. Ұшу қосымшаңыз алғашқы прототиптен бері шақырып келген іздеу endpoint-і бұрын-соңды көрмеген қатені қайтарады, ал кілттеріңізді басқаратын портал енді жоқ. Егер сіз Amadeus Self Service API баламасын іздеп жүрсеңіз, қазір дәл осы жағдайдасыз: жұмыс істеп тұрған өнім, бір провайдердің сұрауларына бейімделген код базасы және пайдаланушылар іздеудің бұзылғанын байқағанша қалған аз уақыт.

Вендор туралы бір ғана дерек айтуға тұрарлық. Amadeus 2026 жылғы 17 шілдеде Self-Service API порталын жапты, ал жаңа әзірлеушілер келісімшартпен жұмыс істейтін Enterprise арнасына бағытталады. Бұл мақала ол туралы осыны ғана айтады. Пайдалы сұрақ басқа: оның орнын не басады және әлі жақсы жұмыс істеп тұрған бөліктерді қайта құрмай, шамамен бір аптада қалай көшуге болады.

Self-service сізге шын мәнінде не берді

Ескі порталды «бір ұшу API-і» ретінде есте сақтап, басқа ұшу API-ін іздеуге шығу оңай. Бірақ бұл оны екі адамдық стартапқа немесе демалыс күнгі жобаға пайдалы еткен нәрсені жіберіп алады. Негізінен үш нәрсе:

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

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

Amadeus Self Service API баламасына апаратын үш жол

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

ЖолАлғашқы нақты брондауға дейінгі уақытҚандай контент күтуге боладыБилеттеу пластинасы кімде
Тікелей GDS келісімшартыЕң ұзақ: коммерциялық тексеру, сертификаттау, содан кейін әзірлеуКең GDS контенті; NDC және лоукостер сіз жасайтын келісімге байланыстыСізде, егер IATA аккредитациясы болса; әйтпесе бәрібір оны иеленетін біреу керек
Агрегатор API-іОрташа: жеңілірек қосылу, бірақ келісімшарт күтіңізGDS, NDC және LCC қоспасы, агрегатор қандай көздерді қосқанына байланыстыӘдетте агрегатор немесе оның билеттеу серіктесі
Консолидатордың API-іКөбіне шығарылған билетке ең қысқа жол, өйткені билеттеу шешілгенКонсолидатор сататын нәрсе: оның келісімшарттық және нетто тарифтері, қоса оның жеткізушілерінің контентіКонсолидатор, өз аккредитациясымен

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

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

Контент бағанын да асықпай оқыңыз. GDS контенті мен NDC контенті бірдей тарифтер емес, ал лоукостер көбіне екеуінде де болмайды. Пайдаланушыларыңыз негізінен LCC-ге толы өңірде қысқа рейстермен ұшса, тамаша GDS қамтуы бар жолдың өзі әлсіз нәтиже беруі мүмкін. Бұл айырмашылықты NDC API әлде GDS: интеграторлар үшін не өзгерді мақаласында талдадық.

Мұнда қолжетімділік қалай жұмыс істейді және неге бұл да жай кілт емес

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

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

Қайда барсаңыз да, бірінші хатта бір нәрсені сұраңыз: self-service тест кілті бар ма және production-ға дейін не болуы керек? Анық жауап интеграцияның қалған бөлігі үшін жақсы белгі. Бұлдыр жауап та бір нәрсе айтады.

Көшу тізімі, нәрселер бұзылатын ретпен

Self-service интеграцияларының көбінің құрылымы бірдей болды: іздеу, баға, тапсырыс жасау, билет шығару, содан кейін билет пайда болғаннан кейінгі жағдайларды өңдеу. Әр қадамды жаңа провайдермен ешқашан жазбағандай қайта тексеріңіз. Сұрау атаулары басқаша болады; зиянды кодыңызда жасырынған болжамдар келтіреді.

  1. Іздеу. Сұрау моделіңізді (шығу, бару, күндер, жолаушылар, салон) жаңа сұрауға сәйкестендіріңіз. Балалар мен нәрестелердің жасы қалай берілетінін, multi-city бөлек шақыру ма екенін және бос нәтиже қалай көрінетінін тексеріңіз. Бос тізім мен қате — әртүрлі нәрселер, ал интерфейсіңіз оларды бірдей қабылдайтын шығар.
  2. Ұсыныс идентификаторы. Ұсыныс id-і қанша уақыт жарамды екенін және бетті қайта жүктегеннен кейін сақталатынын біліңіз. Ұсынысты сессияда сақтап, он минуттан кейін бағасын алатын код жаңа жолдармен істен шығады.
  3. Баға. Провайдерлердің көбінде брондау алдында бағаны қайта тексеру міндетті. Баға өзгерген жағдайды өңдеңіз және сонда пайдаланушы не көретінін шешіңіз.
  4. Тапсырыс. Жолаушылардың аты-жөні, құжат өрістері, байланыс деректері. Жібермес бұрын форматтарды өз жағыңызда тексеріңіз; клиент төлегеннен кейін қабылданбаған тапсырыс — бұл тізімдегі ең қымбат қате.
  5. Билет. Тапсырыс шақыруы билетті де шығара ма, әлде шығару өз уақыт шегі бар бөлек қадам ба, анықтаңыз. Біреудің ақшасын алмас бұрын билет кімнің пластинасымен шығатынын біліңіз.
  6. Билеттен кейін. Бас тарту, void, қайтару, кесте өзгерісі. Бұл прототипке ешқашан керек болмаған, ал тірі өнімге алғашқы айда-ақ керек болатын шақырулар. Олар API-де бар ма, әлде қолдау қызметі арқылы өте ме, сұраңыз.

Нені жалған жасауға болатынын және нені ешқашан жасамау керектігін қоса, толық тест жоспары үшін саяхат API-леріне арналған sandbox тест жоспарымызды қараңыз. Интеграция жағынан келсеңіз, авиабилет брондау API интеграциясы бүкіл ағынды түсіндіреді.

Асығыс көшудің құны

Азғыратын қадам — жаңа провайдерді ескі клиенттік интерфейсіңіздің артына орап, іздеу нәтиже бере бастағанда шығара салу. Іздеу жақсы көрінеді. Демо көрсетпеген барлық нәрсе істен шығады.

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

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

Шамамен бір апта

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

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

Tekravel редакциясы

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

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