Usporedba travel API-ja: ocjenjujte osi, ne dobavljače

Imate otvorene tri prezentacije dobavljača u tri kartice. Svaka ima slajd s dugačkim popisom zrakoplovnih kompanija, slajd s brojem hotela, sandbox, REST i JSON te e-mail podrške. Složite tablicu, stavite kvačicu u svaku ćeliju i tablica završi neriješeno. Tako obično završava usporedba travel API-ja napravljena kao popis značajki — i to je pogrešan kraj, jer se razlike koje će odlučiti vašu sljedeću godinu pokažu tek nakon puštanja u rad: kod rezervacije koja je prošla kod dobavljača, a kod vas istekla uz timeout; kod povrata novca koji nitko ne zna obraditi; kod kompanije koja je bila na popisu, ali se tom rutom za nju ne može izdati karta.
Ovaj tekst je za developera ili tehničkog voditelja koji mora donijeti odluku i kasnije je obraniti. Ne rangira dobavljače. Daje vam osi za usporedbu, plan testiranja koji troši vrijeme na pogreške i kratak skup pitanja iz kojih brzo vidite razgovarate li s dobavljačem ili s preprodavačem tuđeg dobavljača.
Zašto popis značajki uvijek završi neriješeno
Checklista pita postoji li neka mogućnost. Gotovo svaki travel API može reći „da“ na gotovo svaki redak, jer su redci napisani na razini marketinške stranice: pretraživanje, cijena, rezervacija, otkazivanje, izdavanje, webhooks, sandbox. Ono što ih razlikuje nije postoji li cancel, nego što se dogodi kad ga pozovete na izdanoj karti dvanaest sati prije polaska, na tarifi s penalom, preko rute na kojoj je sadržaj došao od treće strane. Za to checklista nema stupac.
Postoji i drugi problem. Checklistu obično ispunjava sam dobavljač. Ocjenjujete njegov vlastiti opis.
Usporedba travel API-ja po osima, ne po dobavljačima
Zamijenite mrežu „dobavljač × značajka“ osima koje sami ocjenjujete, na temelju dokaza prikupljenih tijekom probnog razdoblja. Tablica ispod je ona koju bismo mi koristili. Možda ćete retke vrednovati drukčije — posao samo s hotelima manje brine o izdavanju karata — i vrijedi se s njom posvađati prije nego što je usvojite.
| Os | Što pita checklista | Što zaista treba saznati | Kako zvuči slab odgovor |
|---|---|---|---|
| Pokrivenost | Koliko kompanija i hotela? | Koliko ih se može pretražiti, rezervirati I izdati ili potvrditi preko ovog API-ja, na vašim tržištima | Jedan veliki broj bez raščlambe |
| Dubina | Postoji li endpoint za otkazivanje? | Koje su radnje nakon rezervacije automatizirane po izvoru sadržaja: void, refund, reissue, ispravak imena, dodatne usluge | „To rješava naš operativni tim“ |
| Integritet cijene | Jesu li cijene u stvarnom vremenu? | Koliko se često cijena pri rezervaciji razlikuje od cijene pri pretraživanju i kako vam API to javlja | „Cijene su uvijek live“ |
| Semantika pogrešaka | Jesu li pogreške dokumentirane? | Kaže li vam pogreška u kojem je stanju rezervacija, a ne samo da nešto nije uspjelo | Jedan opći kod za svaku pogrešku |
| Idempotentnost | — | Može li ponovljeni poziv book stvoriti drugu rezervaciju | Tišina, pa „to nismo vidjeli“ |
| Supplier of record | — | Čiji ugovor, čiji IATA broj, kroz čiji BSP karta prolazi | „Radimo sa svim velikim GDS-ovima“ |
| Pristup i podrška | Postoji li sandbox? | Tko odgovara kad se live PNR zaglavi, i koliko brzo | Obrazac za tiket i nijedno ime |
Dva od tih redaka uopće nemaju pitanje u checklisti. Nije slučajno: to su redci koji najviše koštaju kad nešto pođe po zlu, i oni koje prezentacija dobavljača najmanje vjerojatno spomene sama od sebe.
Pokrivenost nije dubina
Popis zrakoplovnih kompanija najvarljiviji je slajd u svakoj prezentaciji. Popis od nekoliko stotina prijevoznika može značiti nekoliko različitih stvari, a samo je jedna od njih ono što želite.
Neki dolaze preko GDS-a i mogu se rezervirati i izdati od početka do kraja. Neki dolaze preko NDC veza, gdje pretraživanje može dobro raditi, ali servisiranje nakon rezervacije — izmjene, djelomični povrati, dodavanje prtljage — za tu kompaniju i dalje može biti ručno. Neki su niskotarifni prijevoznici čiji sadržaj agregira drugi preprodavač; možete ih prikazati, ponekad i rezervirati, a onda karta stiže putem koji ne kontrolirate, u roku koji ne možete obećati kupcu. A neki su na popisu jer se jednom njihova tarifa pojavila u odgovoru na pretraživanje.
Prijevoznik kojeg možete prikazati, ali ne i izdati, nije pokrivenost. Za maloprodajni proizvod gori je od odsutnosti, jer ga kupac odabere, plati i onda čeka.
Hoteli imaju isti oblik, drugim riječima. Broj objekata uključuje i one koje je dobavljač mapirao i one koje nije; statične cijene spremljene u cache prošli tjedan pored dostupnosti u stvarnom vremenu; sobe na allotmentu s release razdobljem pored free sale kapaciteta. Pitajte za broj koji je live rezervabilan u gradovima u kojima prodajete, i pitajte kako se spajaju duplikati među njihovim vlastitim dobavljačima — isti hotel tri puta po tri cijene je tiket podršci koji samo čeka da se dogodi.
Praktični test je uzak. Zapišite dvadeset ruta i dvadeset hotelskih gradova koji čine većinu vašeg prometa — recimo Zagreb–Frankfurt, Split–London, Istanbul, Dubrovnik — i zamolite dobavljača da vam u sandboxu pokaže upravo njih kako rade od početka do kraja: pretraživanje, cijena, rezervacija, izdavanje ili potvrda, otkazivanje. Dobavljač koji ima dubinu to će napraviti bez muke. Dobavljač koji ima slajd počet će pričati o slajdu.
Što testirati u probnom razdoblju: putove pogrešaka, ne sretne putove
Svaki sandbox uspješno rezervira jednosmjernu kartu u ekonomskom razredu na mirnoj ruti. Za to je napravljen. Vaš produkcijski promet provest će znatan dio života na drugim putovima, a probno razdoblje jedini je jeftin trenutak da ih vidite.
Prođite ovaj popis i bilježite što je API vratio uz ono što je poslije stvarno vrijedilo:
- Promjena cijene između pretraživanja i rezervacije. Ne uspije li poziv book, uspije li po novoj cijeni ili vrati zaseban odgovor koji traži potvrdu? Može li vaš UI razlikovati te slučajeve bez raščlanjivanja teksta poruke?
- Istekla ponuda. Pretražite, pričekajte dulje od trajanja ponude, pa rezervirajte. Je li istek zasebna pogreška ili ista kao „dobavljač nedostupan“?
- Rasprodano pri rezervaciji. Kapacitet koji nestane između određivanja cijene i rezervacije. U kojem je stanju rezervacija i oslobađa li se autorizacija plaćanja?
- Ponavljanje nakon timeouta. Pošaljite zahtjev za rezervaciju, prekinite vezu prije odgovora i pošaljite ga ponovno. Imate li sada jedan PNR ili dva? Taj jedan test govori više o dobavljaču nego cijeli ostatak probnog razdoblja zajedno.
- Rezervacija stvorena, izdavanje nije uspjelo. Može li API prijaviti PNR koji postoji, ali nije izdan, i kaže li vam rok za izdavanje?
- Djelomičan neuspjeh. Hotelski zahtjev za više soba gdje se jedna potvrdi, a druga ne. Povratni let gdje odlazak i povratak dolaze iz različitih izvora.
- Otkazivanje izvan besplatnog prozora. Saznate li penal prije potvrde ili tek s računa?
- Ispad dobavljača. Pitajte kako se simulira. Ako ne mogu, pitajte kako su njihovi klijenti saznali kako se sustav ponaša.
Za svaki slučaj ocjenjujete dvije stvari. Prvo: govori li vam API istinu o stanju rezervacije? Drugo: može li vaš kod postupiti prema toj istini a da čovjek ne čita slobodan tekst? S API-jem koji ne uspijeva jasno lakše se živi nego s onim koji uspijeva dvosmisleno.
O letovima smo detaljnije pisali u tekstu što dokumentacija API-ja za rezervaciju letova prešućuje, a o dizajnu klijenta za spore hotelske dobavljače u članku o dostupnosti hotela. Oba dobro idu uz plan testiranja.
Pitanja koja otkrivaju „tanak“ agregator
Nema ničeg lošeg u agregatoru. Većina turističkog sadržaja do većine prodavača stiže upravo preko nekog. Rizik je tanak agregator: sloj koji preprodaje API drugog sloja, dodaje maržu i ne posjeduje ni ugovor s dobavljačem ni operativni desk. Kad se nešto pokvari, odgovor mora putovati dvije tvrtke uzvodno i natrag.
Pet pitanja to brzo iznese na vidjelo:
- Tko je supplier of record za ovu rezervaciju? Na čijem ugovoru sa zrakoplovnom kompanijom ili hotelom počiva?
- Kroz čiji IATA broj i čiji BSP karta prolazi? Ako je odgovor „partnerov“, pitajte tko prima ADM kad se prekrši tarifno pravilo.
- Što se kod vas dogodi kad pozovem cancel? Automatski poziv dobavljaču ili red koji preuzima čovjek?
- Mogu li vidjeti pogrešku iz upstreama? Tanak sloj sklon je svaki neuspjeh sabiti u jedan kod, jer ne razumije u potpunosti pogreške koje prima.
- Koga zovem zbog zaglavljene live rezervacije, i koga oni zovu? Prebrojite karike.
Nijedan od tih odgovora sam po sebi ne diskvalificira. Partnerov IATA broj može biti u redu ako ugovor jasno kaže tko snosi debit memo. Bitno je da dobavljač odgovara precizno i brzo. Maglovite odgovore ovdje dobit ćete i kasnije — u produkciji, u gore vrijeme.
Koliko košta pogrešan izbor
Integracija je jeftini dio. Skupi dijelovi stižu kasnije i ne pojavljuju se ni u jednoj procjeni.
Bug s dvostrukom rezervacijom znači kupca terećenog dvaput i PNR koji morate ručno pronaći i otkazati, možda tek nakon što se besplatni void prozor zatvorio. Rezervacija koja je uspjela upstream dok je vaša strana zabilježila pogrešku znači zadržano mjesto, zatim automatsko otkazivanje i kupca koji misli da ima rezervaciju. Prijevoznik kojeg ste prikazali, a niste mogli izdati, znači povrat novca, ispriku i kupca koji se ne vraća. ADM za tarifno pravilo koje je prekršila ruta dobavljača pada na onoga čija je karta — pobrinite se da unaprijed znate jeste li to vi.
Zatim dolazi cijena promjene. Svaka neobičnost koju upijete — statusni kod s dva značenja, polje koje je ponekad string — završi u vašem modelu podataka. Nakon dvije godine izbor API-ja više nije integracija koju zamijenite u jednom sprintu; to je oblik vaše tablice rezervacija. To je pravi razlog da pažljivo uspoređujete sada.
Gdje se naš API uklapa u ovaj okvir
Nudimo API-je za letove i hotele. Pristup počinje razgovorom, a ne ključem na samoposlugu, što nekim developerima djeluje sporo; razlog je što se upravo u tom razgovoru gornja pitanja postavljaju u oba smjera — koje rute i gradove trebate, koji ćete sadržaj stvarno moći izdati ili potvrditi i tko što rješava nakon rezervacije. Ako radite usporedbu, ponesite ovaj popis. Stranica travel APIs mjesto je gdje taj razgovor počinje.
Što god odabrali, birajte prema dnevniku probnog razdoblja, a ne prema prezentaciji. Prezentacija vam govori što dobavljač želi biti. Putovi pogrešaka govore vam što jest.