Sammenligning af travel API: vurder akserne, ikke leverandørerne

Du har tre leverandørpræsentationer åbne i tre faner. Hver af dem har et slide med en lang liste over flyselskaber, et slide med et hotelantal, en sandbox, REST og JSON, og en supportmail. Du bygger et regneark, sætter flueben i hver celle, og regnearket ender uafgjort. Sådan ender en sammenligning af travel API typisk, når den laves som en funktionstjekliste — og det er den forkerte slutning, for de forskelle, der afgør dit næste år, viser sig først efter go-live: i bookingen, der lykkedes hos leverandøren men fik timeout hos dig, i refunderingen, som ingen kan behandle, i flyselskabet, der stod på listen, men ikke kan udstedes via denne rute.
Artiklen er til udvikleren eller den tekniske leder, der skal træffe beslutningen og forsvare den bagefter. Den rangerer ikke leverandører. Den giver dig akser at sammenligne på, en testplan, der bruger tiden på fejl, og et kort sæt spørgsmål, der hurtigt afslører, om du taler med en leverandør eller med en videresælger af en andens leverandør.
Hvorfor funktionstjeklisten altid ender uafgjort
En tjekliste spørger, om en funktion findes. Næsten ethvert travel API kan svare ja til næsten hver række, fordi rækkerne er skrevet på marketingsidens niveau: søg, pris, book, afbestil, udsted, webhooks, sandbox. Det, der adskiller dem, er ikke om cancel findes, men hvad der sker, når du kalder den på en udstedt booking tolv timer før afgang, på en pris med gebyr, via en rute hvor indholdet kom fra en tredjepart. Det har tjeklisten ingen kolonne til.
Der er et andet problem. Den, der udfylder tjeklisten, er som regel leverandøren selv. Du giver point til deres egen beskrivelse.
En sammenligning af travel API bygget på akser, ikke leverandører
Udskift gitteret med leverandør mod funktion med akser, du selv scorer, ud fra beviser du har samlet i testperioden. Tabellen nedenfor er den, vi selv ville bruge. Du vægter måske rækkerne anderledes — en ren hotelforretning bekymrer sig mindre om udstedelse — og du bør diskutere med den, før du tager den i brug.
| Akse | Hvad tjeklisten spørger om | Hvad du faktisk skal finde ud af | Sådan lyder et svagt svar |
|---|---|---|---|
| Dækning | Hvor mange flyselskaber og hoteller? | Hvor mange der kan søges, bookes OG udstedes eller bekræftes via dette API, på dine markeder | Ét stort tal uden opdeling |
| Dybde | Er der et endpoint til afbestilling? | Hvilke handlinger efter booking der er automatiseret pr. indholdskilde: void, refund, reissue, navnerettelse, tilkøb | »Det klarer vores operations-team« |
| Prisintegritet | Er priserne i realtid? | Hvor ofte prisen ved booking afviger fra prisen ved søgning, og hvordan API'et fortæller dig det | »Priserne er altid live« |
| Fejlsemantik | Er fejlene dokumenteret? | Om en fejl fortæller, hvilken tilstand bookingen er i, ikke bare at noget gik galt | Én generisk fejlkode til alt |
| Idempotens | — | Om et gentaget book-kald kan oprette en ekstra booking | Tavshed, derefter »det har vi ikke set« |
| Leverandør of record | — | Hvis kontrakt, hvis IATA-nummer, hvis BSP billetten går igennem | »Vi arbejder med alle de store GDS'er« |
| Adgang og support | Er der en sandbox? | Hvem svarer, når et live-PNR sidder fast, og hvor hurtigt | En sagsformular og ingen navngiven kontakt |
To af rækkerne har slet ikke noget tjeklistespørgsmål. Det er ikke tilfældigt: det er de rækker, der koster mest, når det går galt, og dem en leverandørpræsentation mindst sandsynligt nævner af sig selv.
Dækning er ikke dybde
Listen over flyselskaber er det mest vildledende slide i enhver præsentation. En liste med flere hundrede selskaber kan betyde flere forskellige ting, og kun én af dem er det, du vil have.
Nogle kommer via et GDS og kan bookes og udstedes hele vejen. Nogle kommer via NDC-forbindelser, hvor søgningen kan fungere fint, men servicering efter booking — ændringer, delvise refunderinger, tilføjelse af bagage — stadig kan være manuel for netop det selskab. Nogle er lavprisselskaber, hvis indhold er samlet fra en anden videresælger; du kan vise dem, nogle gange booke dem, og så ankommer billetten ad en vej, du ikke styrer, med en tidslinje du ikke kan love kunden. Og nogle står på listen, fordi en pris engang dukkede op i et søgesvar.
Et selskab, du kan vise men ikke udstede, er ikke dækning. For et detailprodukt er det værre end fravær, fordi kunden vælger det, betaler og så venter.
Hoteller har samme form med andre ord. Et antal overnatningssteder rummer både dem, leverandøren har mappet, og dem den ikke har; statiske priser cachet i sidste uge ved siden af live-tilgængelighed; værelser på allotment med release-periode ved siden af free sale. Spørg efter det antal, der er live-bookbart i de byer, du sælger, og spørg, hvordan dubletter på tværs af deres egne leverandører flettes — det samme hotel tre gange til tre priser er en supportsag, der venter på at ske.
Den praktiske test er smal. Skriv de tyve ruter og tyve hotelbyer ned, der udgør det meste af din volumen — fx København–London, Billund–Gran Canaria, Barcelona, Bangkok — og bed leverandøren vise netop dem fungere hele vejen i sandboxen: søg, pris, book, udsted eller bekræft, afbestil. En leverandør med dybde gør det uden besvær. En leverandør med et slide begynder at tale om slidet.
Hvad du skal teste: fejlvejene, ikke de lykkelige veje
Enhver sandbox booker en enkeltbillet på økonomiklasse på en stille rute uden problemer. Det er det, sandboxen blev bygget til at vise. Din produktionstrafik vil tilbringe en betydelig del af sit liv på de andre veje, og testperioden er det eneste billige tidspunkt at se dem.
Kør denne liste, og skriv ned, hvad API'et returnerede, ved siden af hvad der faktisk var sandt bagefter:
- Prisændring mellem søgning og booking. Fejler book-kaldet, lykkes det til den nye pris, eller returnerer det et særskilt svar, der beder dig bekræfte? Kan dit UI kende forskel uden at parse en beskedtekst?
- Udløbet tilbud. Søg, vent længere end tilbuddets levetid, og book. Er udløbet en specifik fejl eller den samme som »leverandør nede«?
- Udsolgt ved booking. Kapacitet, der forsvinder mellem prissætning og booking. Hvilken tilstand er bookingen i, og frigives en eventuel betalingsautorisation?
- Gentagelse efter timeout. Send en bookingforespørgsel, afbryd forbindelsen før svaret, og send den igen. Har du nu ét PNR eller to? Denne ene test fortæller mere om en leverandør end resten af testperioden tilsammen.
- Booking oprettet, udstedelse fejlede. Kan API'et melde et PNR, der findes men ikke er udstedt, og oplyser det fristen for udstedelse?
- Delvis fejl. En hotelforespørgsel på flere værelser, hvor ét bekræftes og ét ikke gør. En returrejse, hvor ud- og hjemrejse kommer fra forskellige kilder.
- Afbestilling uden for det gratis vindue. Oplyses gebyret, før du bekræfter, eller opdages det på fakturaen?
- Leverandørnedbrud. Spørg, hvordan man simulerer et. Kan de ikke, så spørg, hvordan deres kunder lærte, hvordan det opfører sig.
For hvert tilfælde scorer du to ting. Først: fortæller API'et sandheden om bookingens tilstand? Dernæst: kan din kode handle på den sandhed, uden at et menneske læser fritekst? Et API, der fejler tydeligt, er lettere at leve med end et, der lykkes tvetydigt.
Vi har skrevet mere om flysiden i det dokumentationen til et flybooking-API udelader, og om at designe en klient til langsomme hotelleverandører i artiklen om hoteltilgængelighed. Begge passer godt sammen med en testplan.
Spørgsmål, der afslører en tynd aggregator
Der er intet galt med en aggregator. Det meste rejseindhold når de fleste sælgere gennem en. Risikoen er den tynde: et lag, der videresælger et andet lags API, lægger en margin på og hverken ejer leverandørkontrakten eller det operationelle desk. Når noget går i stykker, skal svaret rejse to virksomheder op ad strømmen og tilbage.
Fem spørgsmål får det hurtigt frem:
- Hvem er leverandør of record for denne booking? Hvis kontrakt med flyselskabet eller hotellet hviler den på?
- Gennem hvis IATA-nummer og BSP går billetten? Hvis svaret er »en partners«, så spørg, hvem der modtager ADM'en, når en prisregel brydes.
- Hvad sker der hos jer, når jeg kalder cancel? Et automatisk kald til leverandøren eller en kø, som et menneske tager?
- Kan jeg se fejlen opstrøms? Et tyndt lag har en tendens til at presse enhver fejl ned i én kode, fordi det ikke fuldt forstår de fejl, det modtager.
- Hvem ringer jeg til om en fastlåst live-booking, og hvem ringer de til? Tæl leddene.
Ingen af svarene diskvalificerer i sig selv. En partners IATA-nummer kan være fint, hvis kontrakten klart siger, hvem der bærer debit memo'et. Det, der betyder noget, er at leverandøren svarer præcist og hurtigt. Vage svar her er de svar, du får senere, i produktion, på et værre tidspunkt.
Hvad et forkert valg koster
Integrationen er den billige del. De dyre dele kommer senere og står ikke i noget estimat.
En fejl med dobbeltbooking betyder en kunde, der er trukket to gange, og et PNR, du skal finde og annullere manuelt, måske efter at det gratis void-vindue er lukket. En booking, der lykkedes opstrøms, mens din side registrerede en fejl, betyder et sæde, der blev holdt, derefter annulleret automatisk, og en kunde, der tror, de er booket. Et selskab, du viste men ikke kunne udstede, betyder refundering, en undskyldning og en kunde, der ikke kommer igen. En ADM for en prisregel, leverandørens rute brød, lander hos den, der ejer billetten — sørg for at vide på forhånd, om det er dig.
Så er der omkostningen ved at skifte. Hver særhed, du absorberer — en statuskode med to betydninger, et felt der nogle gange er en streng — ender i din datamodel. To år inde er valget af API ikke længere en integration, du udskifter på et sprint; det er formen på din bookingtabel. Det er den egentlige grund til at sammenligne grundigt nu.
Hvordan vores eget API passer ind
Vi udbyder fly- og hotel-API'er. Adgang begynder med en samtale frem for en selvbetjeningsnøgle, hvilket nogle udviklere synes er langsomt; grunden er, at det er i samtalen, spørgsmålene ovenfor stilles begge veje — hvilke ruter og byer du har brug for, hvilket indhold du reelt vil kunne udstede eller bekræfte, og hvem der håndterer hvad efter bookingen. Hvis du er i gang med en sammenligning, så tag listen med. Siden om travel APIs er der, hvor samtalen starter.
Uanset hvad du vælger, så vælg ud fra testloggen og ikke præsentationen. Præsentationen fortæller, hvad en leverandør gerne vil være. Fejlvejene fortæller, hvad den er.