Поређење travel API-ја: оцењујте осе, не добављаче

Имате отворене три презентације добављача у три картице. Свака има слајд са дугачком листом авио-компанија, слајд са бројем хотела, sandbox, REST и JSON, и имејл подршке. Направите табелу, ставите квачицу у сваку ћелију, и табела се заврши нерешено. Тако се обично завршава поређење travel API-ја које се ради као листа функција — и то је погрешан крај, јер се разлике које ће одлучити вашу следећу годину виде тек после пуштања у рад: код резервације која је прошла код добављача, а код вас истекла уз timeout; код повраћаја новца који нико не уме да обради; код авио-компаније која је била на листи, али се преко ове руте за њу не може издати карта.
Овај текст је за програмера или техничког руководиоца који мора да донесе одлуку и касније је одбрани. Не рангира добављаче. Даје вам осе за поређење, план тестирања који троши време на грешке и кратак скуп питања из којих брзо видите да ли разговарате са добављачем или са препродавцем туђег добављача.
Зашто се листа функција увек заврши нерешено
Чеклиста пита да ли нека могућност постоји. Скоро сваки travel API може да каже „да“ на скоро сваки ред, јер су редови написани на нивоу маркетиншке странице: претрага, цена, резервација, отказивање, издавање, webhooks, sandbox. Оно што их разликује није да ли постоји cancel, већ шта се деси када га позовете на издатој карти дванаест сати пре полетања, на тарифи са пеналом, преко руте на којој је садржај дошао од треће стране. За то чеклиста нема колону.
Постоји и други проблем. Чеклисту обично попуњава сам добављач. Оцењујете његов сопствени опис.
Поређење travel API-ја по осама, не по добављачима
Замените мрежу „добављач × функција“ осама које сами оцењујете, на основу доказа прикупљених током пробног периода. Табела испод је она коју бисмо ми користили. Можда ћете редове вредновати другачије — посао само са хотелима мање брине о издавању карата — и вреди се с њом расправити пре него што је усвојите.
| Оса | Шта пита чеклиста | Шта заиста треба сазнати | Како звучи слаб одговор |
|---|---|---|---|
| Покривеност | Колико авио-компанија и хотела? | Колико се може претражити, резервисати И издати или потврдити преко овог API-ја, на вашим тржиштима | Један велики број без поделе |
| Дубина | Постоји ли endpoint за отказивање? | Које радње после резервације су аутоматизоване по извору садржаја: void, refund, reissue, исправка имена, додатне услуге | „То решава наш оперативни тим“ |
| Интегритет цене | Да ли су цене у реалном времену? | Колико често се цена при резервацији разликује од цене при претрази и како вам API то саопштава | „Цене су увек live“ |
| Семантика грешака | Да ли су грешке документоване? | Да ли вам грешка каже у ком је стању резервација, а не само да нешто није успело | Један општи код за сваку грешку |
| Идемпотентност | — | Да ли поновљени позив book може да направи другу резервацију | Тишина, па „то нисмо видели“ |
| Supplier of record | — | Чији уговор, чији IATA број, кроз чији BSP карта пролази | „Радимо са свим великим GDS системима“ |
| Приступ и подршка | Постоји ли sandbox? | Ко одговара када се live PNR заглави, и колико брзо | Формулар за тикет и ниједно име |
Два од тих редова уопште немају питање у чеклисти. То није случајно: то су редови који најскупље коштају када нешто пође наопако, и они које презентација добављача најмање вероватно помене сама.
Покривеност није дубина
Листа авио-компанија је најобмањујући слајд у свакој презентацији. Листа од неколико стотина превозника може значити неколико различитих ствари, а само једна од њих је оно што желите.
Неки долазе преко GDS-а и могу се резервисати и издати од почетка до краја. Неки долазе преко NDC веза, где претрага може радити добро, али сервисирање после резервације — измене, делимични повраћаји, додавање пртљага — за ту авио-компанију и даље може бити ручно. Неки су нискотарифни превозници чији садржај агрегира други препродавац; можете их приказати, понекад и резервисати, а онда карта стиже путем који не контролишете, у року који не можете обећати купцу. А неки су на листи зато што се једном њихова тарифа појавила у одговору на претрагу.
Превозник ког можете приказати, али не и издати, није покривеност. За малопродајни производ гори је од одсуства, јер га купац изабере, плати, па чека.
Хотели имају исти облик, другим речима. Број објеката обухвата и оне које је добављач мапирао и оне које није; статичне цене кеширане прошле недеље поред доступности у реалном времену; собе на allotment-у са release периодом поред free sale капацитета. Питајте за број који је live резервабилан у градовима у којима продајете, и питајте како се спајају дупликати међу њиховим сопственим добављачима — исти хотел три пута по три цене је тикет подршци који само чека да се догоди.
Практични тест је узак. Запишите двадесет рута и двадесет хотелских градова који чине највећи део вашег обима — рецимо Београд–Беч, Београд–Истанбул, Анталија, Хургада — и замолите добављача да вам у sandbox-у покаже управо њих како раде од почетка до краја: претрага, цена, резервација, издавање или потврда, отказивање. Добављач који има дубину урадиће то без муке. Добављач који има слајд почеће да прича о слајду.
Шта тестирати у пробном периоду: путеве грешака, не срећне путеве
Сваки sandbox успешно резервише једносмерну карту у економској класи на мирној рути. За то је направљен. Ваш продукциони саобраћај провешће значајан део живота на другим путевима, а пробни период је једини јефтин тренутак да их видите.
Прођите кроз ову листу и бележите шта је API вратио поред онога што је после стварно важило:
- Промена цене између претраге и резервације. Да ли позив book не успе, успе по новој цени, или врати посебан одговор који тражи потврду? Може ли ваш UI да разликује те случајеве без рашчлањивања текста поруке?
- Истекла понуда. Претражите, сачекајте дуже од трајања понуде, па резервишите. Да ли је истек посебна грешка или иста као „добављач недоступан“?
- Распродато при резервацији. Капацитет који нестане између одређивања цене и резервације. У ком је стању резервација и да ли се ослобађа ауторизација плаћања?
- Понављање после timeout-а. Пошаљите захтев за резервацију, прекините везу пре одговора и пошаљите га поново. Имате ли сада један PNR или два? Тај један тест говори више о добављачу него цео остатак пробног периода заједно.
- Резервација направљена, издавање није успело. Може ли API да пријави PNR који постоји али није издат, и да ли вам каже рок за издавање?
- Делимичан неуспех. Хотелски захтев за више соба где се једна потврди, а друга не. Повратни лет где одлазак и повратак долазе из различитих извора.
- Отказивање ван бесплатног прозора. Да ли сазнате пенал пре потврде или тек са фактуре?
- Пад добављача. Питајте како се симулира. Ако не могу, питајте како су њихови клијенти сазнали како се систем понаша.
За сваки случај оцењујете две ствари. Прво: да ли вам API говори истину о стању резервације? Друго: може ли ваш код да поступи по тој истини а да човек не чита слободан текст? Са API-јем који не успева јасно лакше се живи него са оним који успева двосмислено.
О летовима смо детаљније писали у тексту шта документација API-ја за резервацију летова прећуткује, а о дизајну клијента за споре хотелске добављаче у чланку о доступности хотела. Оба добро иду уз план тестирања.
Питања која откривају „танак“ агрегатор
Нема ничег лошег у агрегатору. Већина туристичког садржаја стиже до већине продаваца управо преко неког. Ризик је танак агрегатор: слој који препродаје API другог слоја, додаје маржу и не поседује ни уговор са добављачем ни оперативни деск. Када се нешто поквари, одговор мора да путује две компаније узводно и назад.
Пет питања то брзо изнесе на видело:
- Ко је supplier of record за ову резервацију? На чијем уговору са авио-компанијом или хотелом почива?
- Кроз чији IATA број и чији BSP карта пролази? Ако је одговор „партнеров“, питајте ко прима ADM када се прекрши тарифно правило.
- Шта се код вас деси када позовем cancel? Аутоматски позив добављачу или ред који преузима човек?
- Могу ли да видим грешку из upstream-а? Танак слој има тенденцију да сваки неуспех сабије у један код, јер не разуме у потпуности грешке које прима.
- Кога зовем због заглављене live резервације, и кога они зову? Пребројте карике.
Ниједан од ових одговора сам по себи не дисквалификује. Партнеров IATA број може бити у реду ако уговор јасно каже ко сноси debit memo. Битно је да добављач одговара прецизно и брзо. Магловити одговори овде су одговори које ћете добити касније — у продукцији, у горе време.
Колико кошта погрешан избор
Интеграција је јефтин део. Скупи делови стижу касније и не појављују се ни у једној процени.
Баг са дуплом резервацијом значи купца задуженог два пута и PNR који морате ручно да пронађете и откажете, можда тек пошто се бесплатни void прозор затворио. Резервација која је успела upstream док је ваша страна забележила грешку значи задржано место, па аутоматско отказивање, и купца који мисли да има резервацију. Превозник ког сте приказали, а нисте могли да издате, значи повраћај новца, извињење и купца који се не враћа. ADM за тарифно правило које је прекршила рута добављача пада на онога чија је карта — постарајте се да унапред знате да ли сте то ви.
Затим долази цена промене. Свака необичност коју упијете — статусни код са два значења, поље које је понекад string — заврши у вашем моделу података. После две године избор API-ја више није интеграција коју замените у једном спринту; то је облик ваше табеле резервација. То је прави разлог да пажљиво поредите сада.
Где се наш API уклапа у овај оквир
Нудимо API за летове и хотеле. Приступ почиње разговором, а не кључем на самоуслугу, што неким програмерима делује споро; разлог је што се управо у том разговору горња питања постављају у оба смера — које руте и градове вам требају, који садржај ћете заиста моћи да издате или потврдите и ко шта решава после резервације. Ако радите поређење, понесите ову листу. Страница travel APIs је место где тај разговор почиње.
Шта год да изаберете, бирајте према дневнику пробног периода, а не према презентацији. Презентација вам каже шта добављач жели да буде. Путеви грешака вам кажу шта јесте.