Beste vluchtboekings-API: zeg eerst wat je bouwt

De opdracht luidt: vind de beste vluchtboekings-API. Dus open je drie vergelijkingspagina's, en die zetten hetzelfde handjevol namen in drie verschillende volgordes, elk met een raster vol vinkjes. Bij de derde pagina zie je wat geen van alle vroeg: wat er met de klant gebeurt nadat de zoekresultaten terugkomen.
Die ontbrekende vraag is het hele antwoord. De beste vluchtboekings-API voor een pagina die bezoekers naar de site van een luchtvaartmaatschappij stuurt, is een slechte keuze voor een site die zelf de boeking en de betaling afhandelt. En geen van beide past bij de interne tool waar het personeel van een reisbureau de hele dag mee werkt. Zoeken, prijzen en boeken zien er in elke documentatie hetzelfde uit. Het verschil zit eronder, en welk verschil jou pijn doet, hangt volledig af van het product.
Drie producten die allemaal "een vluchtboekingssite" heten
Het eerste is een vergelijkings- of inspiratiepagina: tarieven tonen, doorlinken, het ticket nooit aanraken. Hier is de API bijna alleen zoeken. Je wilt weten hoe breed en hoe vers de resultaten zijn, en of een getoonde prijs dicht genoeg ligt bij wat de bezoeker bij aankomst ziet. Niets in je systeem hoeft ooit iets te voiden, terug te betalen of opnieuw uit te geven, dus de kracht van een aanbieder op dat vlak is aan jou verspild.
Het tweede verkoopt. De bezoeker betaalt jou, jij boekt, en vanaf dat moment ben je eigenaar van een boekingslevenscyclus: de prijs bevestigen voordat je afschrijft, een maatschappij opvangen die traag antwoordt, op de dag zelf voiden, later terugbetalen, opnieuw uitgeven als de klant de datum wijzigt. Voor dit product is het zoek-endpoint het makkelijke deel. Wat de keuze beslist, komt erna.
Het derde is de eigen tool van een reisbureau, gebruikt door personeel dat al relaties met leveranciers heeft. Ruwe zoekresultaten zijn niet het punt. Het gaat erom dat de eigen onderhandelde content van het bureau verschijnt, dat subagenten aan kredietlimieten worden gehouden, dat marges worden toegepast voordat iemand een prijs ziet, en dat er aan het eind van de maand rapporten zijn. Een API die uitblinkt in het tweede product kan hier toch het verkeerde fundament zijn.
Het is goed om het ronduit te zeggen: dezelfde API kan niet in alle drie de beste zijn. Beweert een ranglijst dat wel, dan heeft die het tweede product nooit ontmoet.
De eigenschappen die het vergelijken waard zijn, en wie erop leunt
Kleed het functieraster uit tot de rijen waarover een ontwikkelaar het werkelijk oneens zou kunnen zijn. Elk product leunt op een andere deelverzameling; de rest kun je gerust negeren.
| Eigenschap | Doorverwijspagina | Verkoopt en int betaling | Tool voor bureaupersoneel |
|---|---|---|---|
| Hoe verouderd een getoonde prijs mag zijn voordat hij wordt bevestigd | Telt een beetje | Beslissend: je schrijft erop af | Telt, personeel offreert erop |
| Wat een boeking teruggeeft als de maatschappij traag is | Niet van toepassing | Beslissend | Telt |
| Wie kan voiden en terugbetalen, en hoe dat wordt aangevraagd | Niet van toepassing | Beslissend | Beslissend |
| Hoe een boeking met onbekende uitkomst wordt opgelost | Niet van toepassing | Beslissend: de kaart is misschien al belast | Telt |
| Of de eigen content en kredietregels van het bureau gelden | Niet van toepassing | Soms | Beslissend |
| Hoe testgedrag verschilt van live | Laag | Hoog | Hoog |
Lees je eigen kolom en negeer de rest. De fout die geld kost: de doorverwijskolom lezen omdat die het makkelijkst te beoordelen is, en dan het tweede product bouwen.
De prijs die je toont is nog niet de prijs die je afschrijft
Neem het tweede product en volg één tarief erdoorheen. De zoekopdracht geeft een prijs. De bezoeker bekijkt hem, denkt na, opent een ander tabblad en komt terug. Een tijd later drukt hij op de knop. Tussen de zoekopdracht en de knop heeft het tarief in je systeem gelegen, en de enige eerlijke vraag over welke API dan ook is wat die zegt als je het op dat moment opnieuw vraagt.
Een aanbieder kan drie antwoorden geven. Hij kan de getoonde prijs bevestigen. Hij kan een nieuwe prijs teruggeven, waarna je code moet beslissen: het verschil afschrijven, de klant vragen of stoppen. Of hij kan zeggen dat het tarief weg is. Een site die alleen op het eerste antwoord is voorbereid, werkt in elke demo en faalt in de weken daarna, en faalt op een manier die geld kost in plaats van foutmeldingen te geven.
De ontwerpvraag is dus niet of de API een stap voor prijsbevestiging heeft. Bijna allemaal hebben ze die. Het gaat erom hoe het antwoord er bij alle drie de uitkomsten uitziet, en of je code ze uit elkaar kan houden zonder te gokken. Vraag om een voorbeeld van elk. Een aanbieder die het tweede en derde in zijn documentatie laat zien, heeft over jouw product nagedacht. Een die alleen het eerste laat zien, heeft over de demo nagedacht.
Een test van één middag die geen raster je geeft
Wat de shortlist ook is, doe met elke naam dezelfde korte test, en lok de fouten bewust uit. Boek iets en kijk wat het boekingsobject bewaart zodra het ticket is uitgegeven. Controleer de prijs van dezelfde reisroute twee keer, met minuten ertussen, en kijk hoe het tweede antwoord zich tot het eerste verhoudt. Annuleer, vraag daarna een terugbetaling aan, en noteer wie moet handelen. Stel de aanbieder dan schriftelijk twee vragen: wat geeft jullie systeem terug als een maatschappij halverwege een boeking een time-out geeft, en hoe kom ik erachter wat er werkelijk is gebeurd.
De schriftelijke antwoorden zijn meer waard dan de demo. Een aanbieder met een heldere procedure voor een onbekende uitkomst heeft het probleem al eens gezien. Een aanbieder die antwoordt met de naam van een functie, niet.
Voor het opzetten van het testplan zelf behandelt het sandbox-testplan wat de sandbox je niet laat zien. En weeg je aanbieders af op wat er achter de API staat in plaats van op de API zelf, dan is dat een aparte vraag met een eigen artikel; dit stuk blijft bij het product.
Wat het kost om te kiezen op de lijst met endpoints
De fouten zijn stil. Een site bevestigt prijzen te laat, dus het verschil tussen het getoonde en het echte tarief gaat van je marge af, boeking voor boeking. Een boeking blijft in onbekende staat hangen terwijl de kaart van de klant al is belast, en iemand moet het met de hand rechtzetten, meestal per e-mail, meestal in het weekend. Een tool gebouwd op content die alleen voor zoeken dient, blijkt iets waaruit personeel geen tickets kan uitgeven, en het project wordt opnieuw opgebouwd rond andere content.
Niets hiervan zie je in een raster met vinkjes. Alles was zichtbaar in de eerste kolom van de tabel hierboven, voordat er één regel code was geschreven.
Onze eigen positie is smaller dan een ranglijst ons zou laten beweren. Tekravel biedt API's voor vluchten en hotels, toegang begint met een gesprek en niet met een selfservicesleutel, diensten worden per tenant aangezet en leverancierscontent bereikt een tenant via leveranciersgroepen. Dat past bij het tweede en derde product. Bouw je het eerste, dan heb je ons misschien helemaal niet nodig. Bouw je een van de andere, dan is de API-pagina de plek om het gesprek te beginnen.