Bedste API til flybooking: sig først, hvad I bygger

Opgaven lyder: find det bedste API til flybooking. Så I åbner tre sammenligningssider, og de rangerer den samme håndfuld navne i tre forskellige rækkefølger, hver med et skema fyldt med flueben. Ved den tredje side opdager I, hvad ingen af dem spurgte om: hvad der sker med kunden, efter at søgeresultaterne er kommet tilbage.
Det manglende spørgsmål er hele svaret. Det bedste API til flybooking for en side, der sender besøgende videre til et flyselskabs hjemmeside, er et dårligt valg for et site, der selv tager bookingen og kortbetalingen. Og ingen af dem passer til det interne værktøj, som et rejsebureaus personale bruger hele dagen. Søgning, pris og booking ser ens ud i al dokumentation. Det, der adskiller dem, ligger nedenunder, og hvilken forskel der gør ondt, afhænger helt af produktet.
Tre produkter, som alle bliver kaldt "et flybookingsite"
Det første er en sammenlignings- eller inspirationsside: vis priser, link videre, rør aldrig billetten. Her er API'et næsten kun søgning. I går op i, hvor brede og friske resultaterne er, og om en vist pris ligger tæt nok på den, den besøgende ser ved ankomsten. Intet i jeres system skal nogensinde lave void, refundere eller genudstede, så en leverandørs styrke dér er spildt på jer.
Det andet sælger. Den besøgende betaler jer, I booker, og fra det øjeblik ejer I bookingens livscyklus: bekræft prisen før I trækker beløbet, håndter et flyselskab, der svarer langsomt, annuller samme dag, refunder senere, genudsted, når kunden skifter dato. For dette produkt er søge-endpointet den lette del. Det, der afgør valget, kommer bagefter.
Det tredje er bureauets eget værktøj, brugt af personale, der allerede har leverandøraftaler. Rå søgning er ikke pointen. Det afgørende er, at bureauets eget forhandlede indhold vises, at underagenter holdes inden for kreditgrænser, at avancer lægges på, før nogen ser en pris, og at der findes rapporter ved månedens udgang. Et API, der er fremragende til det andet produkt, kan stadig være det forkerte fundament her.
Det er værd at sige ligeud: det samme API kan ikke være bedst til alle tre. Påstår en rangliste det, har den aldrig mødt det andet.
Egenskaberne, der er værd at sammenligne, og hvem der læner sig op ad dem
Skær funktionsskemaet ned til de rækker, en udvikler reelt kunne være uenig om. Hvert produkt læner sig op ad sin egen delmængde, og resten kan I roligt ignorere.
| Egenskab | Viderestillingsside | Sælger og tager imod betaling | Værktøj til bureauets personale |
|---|---|---|---|
| Hvor gammel en vist pris må være, før den bekræftes | Betyder lidt | Afgørende: I trækker beløbet på den | Betyder noget, personalet giver tilbud på den |
| Hvad en booking returnerer, når flyselskabet er langsomt | Ikke relevant | Afgørende | Betyder noget |
| Hvem der kan annullere og refundere, og hvordan det anmodes | Ikke relevant | Afgørende | Afgørende |
| Hvordan en booking med ukendt udfald afklares | Ikke relevant | Afgørende: kortet kan allerede være belastet | Betyder noget |
| Om bureauets eget indhold og kreditregler gælder | Ikke relevant | Nogle gange | Afgørende |
| Hvor meget testadfærd adskiller sig fra drift | Lav | Høj | Høj |
Læs jeres kolonne og ignorer de andre. Fejlen, der koster penge, er at læse viderestillingskolonnen, fordi den er nemmest at vurdere, og så bygge det andet produkt.
Prisen, I viser, er endnu ikke prisen, I trækker
Tag det andet produkt og følg én pris igennem det. Søgningen returnerer en pris. Den besøgende kigger på den, tænker over den, åbner en anden fane og kommer tilbage. Lidt senere trykker vedkommende på knappen. Mellem søgningen og knappen har prisen ligget i jeres system, og det eneste ærlige spørgsmål til et hvilket som helst API er, hvad det svarer, når I spørger igen netop da.
En leverandør kan give tre svar. Den kan bekræfte den pris, I viste. Den kan returnere en ny pris, og jeres kode skal afgøre, om den trækker forskellen, spørger kunden eller stopper. Eller den kan sige, at prisen er væk. Et site, der kun har planlagt for det første svar, virker i hver demo og fejler i ugerne efter, og det fejler på en måde, der koster penge frem for at kaste fejl.
Designspørgsmålet er altså ikke, om API'et har et trin til prisbekræftelse. Næsten alle har det. Det er, hvordan svaret ser ud for alle tre udfald, og om jeres kode kan skelne dem uden at gætte. Bed om et eksempel på hvert. En leverandør, der viser det andet og tredje i sin dokumentation, har tænkt på jeres produkt. En, der kun viser det første, har tænkt på demoen.
En eftermiddagstest, som intet skema kan give jer
Uanset kortlisten, kør den samme korte test på hvert navn, og fremprovoker fejlene med vilje. Book noget og se, hvad bookingobjektet beholder, når billetten er udstedt. Tjek prisen på den samme rejserute to gange, med få minutters mellemrum, og se, hvordan det andet svar forholder sig til det første. Annuller, bed derefter om refusion, og noter, hvem der skal handle. Stil så leverandøren to spørgsmål, skriftligt: hvad returnerer jeres system, når et flyselskab får timeout midt i en booking, og hvordan finder jeg ud af, hvad der faktisk skete.
De skriftlige svar er mere værd end demoen. En leverandør med en klar procedure for ukendt udfald har mødt problemet før. En, der svarer med navnet på en funktion, har ikke.
Hvordan selve testplanen bygges, gennemgår sandkasseplanen, herunder hvad sandkassen ikke viser jer. Og hvis I vejer leverandører efter, hvad der står bag API'et frem for API'et selv, er det et separat spørgsmål med sin egen artikel; denne her bliver ved produktet.
Hvad I betaler, hvis I vælger efter endpoint-listen
Fejlene er stille. Et site bekræfter priser sent, så forskellen mellem den viste og den reelle pris går fra jeres avance, én booking ad gangen. En booking efterlades i ukendt tilstand med kundens kort allerede belastet, og nogen må rydde op i hånden, som regel via e-mail, som regel i en weekend. Et værktøj bygget på indhold, der kun duer til søgning, viser sig at være noget, personalet ikke kan udstede billetter fra, og projektet bygges om omkring andet indhold.
Intet af dette ses i et skema med flueben. Det hele kunne ses i første kolonne af tabellen ovenfor, før en eneste linje kode var skrevet.
Vores egen position er smallere, end en rangliste ville lade os påstå. Tekravel stiller API'er til fly og hoteller til rådighed, adgang begynder med en samtale frem for en selvbetjeningsnøgle, tjenester slås til per tenant, og leverandørindhold når en tenant gennem leverandørgrupper. Det passer til det andet og tredje produkt. Bygger I det første, har I måske slet ikke brug for os. Bygger I et af de andre, er API-siden stedet at starte samtalen.