Reis-API's vergelijken: beoordeel de assen, niet de leveranciers

Je hebt drie leverancierspresentaties open in drie tabbladen. Elk heeft een slide met een lange lijst luchtvaartmaatschappijen, een slide met een aantal hotels, een sandbox, REST en JSON, en een supportadres. Je bouwt een spreadsheet, zet een vinkje in elke cel, en de spreadsheet eindigt in een gelijkspel. Zo loopt een vergelijking van reis-API's meestal af als je haar als featurechecklist aanpakt, en het is het verkeerde einde. De verschillen die je komende jaar bepalen, worden pas zichtbaar na de go-live: bij de boeking die bij de leverancier lukte maar aan jouw kant in een timeout liep, bij de terugbetaling die niemand kan verwerken, bij de maatschappij die wel op de lijst stond maar via deze route niet te ticketen is.
Dit stuk is voor de developer of technisch lead die die keuze moet maken en later moet verdedigen. Het rangschikt geen leveranciers. Het geeft je assen om op te vergelijken, een trialplan dat zijn tijd aan fouten besteedt, en een korte reeks vragen die snel laten zien of je met een leverancier praat of met de wederverkoper van andermans leverancier.
Waarom de featurechecklist altijd gelijk eindigt
Een checklist vraagt of een functie bestaat. Bijna elke reis-API kan op bijna elke regel ja zeggen, want de regels zijn geschreven op het niveau van de marketingpagina: zoeken, prijzen, boeken, annuleren, ticketen, webhooks, sandbox. De vraag die ze onderscheidt is niet of cancel bestaat, maar wat er gebeurt als je het aanroept op een geticketde boeking twaalf uur voor vertrek, op een tarief met boete, via een route waarbij de content van een derde komt. Daar heeft een checklist geen kolom voor.
Er is een tweede probleem. Wie de checklist invult, is meestal de leverancier zelf. Je geeft een cijfer aan zijn zelfbeschrijving.
Reis-API's vergelijken op assen in plaats van op leveranciers
Vervang het raster leverancier-per-feature door assen die je zelf scoort, op basis van bewijs dat je tijdens de trial verzamelt. Onderstaande tabel is degene die wij zouden gebruiken. Je kunt de regels anders wegen — een bedrijf dat alleen hotels verkoopt, geeft minder om ticketing — en het loont om er eerst over te discussiëren voordat je hem overneemt.
| As | Wat een checklist vraagt | Wat je echt wilt weten | Hoe een zwak antwoord klinkt |
|---|---|---|---|
| Dekking | Hoeveel maatschappijen en hotels? | Hoeveel je via deze API kunt zoeken, boeken ÉN ticketen of bevestigen, in jouw markten | Eén groot getal zonder uitsplitsing |
| Diepgang | Is er een annuleer-endpoint? | Welke acties na de boeking per contentbron geautomatiseerd zijn: void, refund, heruitgifte, naamcorrectie, ancillaries | „Daar zorgt ons operationele team voor” |
| Prijsintegriteit | Is de prijs realtime? | Hoe vaak de prijs bij boeken afwijkt van die bij zoeken, en hoe de API je dat laat weten | „Prijzen zijn altijd live” |
| Foutsemantiek | Zijn de fouten gedocumenteerd? | Of een fout vertelt in welke staat de boeking zit, en niet alleen dat er iets misging | Eén generieke foutcode voor alles |
| Idempotentie | — | Of een herhaalde boekingsaanroep een tweede boeking kan aanmaken | Stilte, daarna „dat hebben we nooit gezien” |
| Contractuele leverancier | — | Wiens contract, wiens IATA-nummer, wiens BSP het ticket doorloopt | „We werken met alle grote GDS'en” |
| Toegang en support | Is er een sandbox? | Wie antwoordt als een live PNR vastloopt, en hoe snel | Een ticketformulier en geen contactpersoon met een naam |
Twee van die regels hebben helemaal geen checklistvraag. Dat is geen toeval: het zijn de regels die het meest kosten als ze misgaan, en die een verkooppresentatie het minst geneigd is uit zichzelf te noemen.
Dekking is geen diepgang
De lijst met maatschappijen is de meest misleidende slide in elke presentatie. Een lijst van enkele honderden carriers kan verschillende dingen betekenen, en maar één daarvan is wat je zoekt.
Een deel van die carriers komt via een GDS binnen en is van begin tot eind te boeken en te ticketen. Een ander deel komt via NDC-koppelingen, waar het zoeken goed kan werken maar de service na de boeking — wijzigingen, gedeeltelijke terugbetalingen, een koffer toevoegen — voor die maatschappij nog handwerk kan zijn. Weer andere zijn prijsvechters waarvan de content bij een andere wederverkoper wordt opgehaald: je kunt ze tonen, soms boeken, en daarna komt het ticket via een route die je niet beheerst, met een doorlooptijd die je de klant niet kunt beloven. En sommige staan op de lijst omdat er ooit een tarief in een zoekresultaat opdook.
Een carrier die je kunt tonen maar niet kunt ticketen, is geen dekking. Voor een retailproduct is het erger dan afwezigheid, want de klant kiest hem, betaalt, en wacht dan.
Hotels hebben dezelfde vorm met andere woorden. Een aantal accommodaties omvat panden die de leverancier heeft gemapt en panden die hij niet heeft gemapt; statische tarieven die vorige week zijn gecachet naast live beschikbaarheid; kamers op allotment met een releaseperiode naast free-sale-voorraad. Vraag naar het aantal dat live boekbaar is in de steden waar jij verkoopt, en vraag hoe dubbele vermeldingen tussen hun eigen leveranciers worden samengevoegd. Hetzelfde hotel dat drie keer voor drie prijzen verschijnt, is een supportticket dat op ontstaan wacht.
De praktijktoets is smal. Schrijf de twintig routes en twintig hotelsteden op die het grootste deel van je volume dragen — denk aan Amsterdam–Dubai, Brussel–Istanbul, hotels in Dubai en Antalya — en vraag de leverancier precies die van begin tot eind werkend te laten zien in de sandbox: zoeken, prijzen, boeken, ticketen of bevestigen, annuleren. Een leverancier met diepgang doet dat zonder gedoe. Een leverancier met alleen de slide gaat over de slide praten.
Wat je in een trial test: foutpaden, geen gelukkige paden
Elke sandbox boekt met succes een enkele reis in economy op een rustige route. Daarvoor is de sandbox gebouwd. Je productieverkeer brengt een aanzienlijk deel van zijn leven door op de andere paden, en de trial is het enige goedkope moment om ze te zien.
Gebruik de trial om deze lijst af te werken, en noteer wat de API teruggaf naast wat er daarna werkelijk waar bleek:
- Prijswijziging tussen zoeken en boeken. Faalt de boekingsaanroep, slaagt hij tegen de nieuwe prijs, of geeft hij een apart antwoord dat om bevestiging vraagt? Kan jouw interface het verschil zien zonder een berichttekst te parsen?
- Verlopen aanbod. Zoek, wacht langer dan de geldigheid van het aanbod die de leverancier opgeeft, en boek dan. Is het verlopen een specifieke fout, of dezelfde fout als „leverancier niet bereikbaar”?
- Uitverkocht bij het boeken. Voorraad die verdwijnt tussen prijs en boeking. In welke staat zit de boeking, en wordt een eventuele betalingsautorisatie vrijgegeven?
- Herhaling na een timeout. Stuur een boekingsverzoek, verbreek de verbinding vóór het antwoord, en stuur het opnieuw. Heb je nu één PNR of twee? Deze ene test vertelt je meer over een leverancier dan de rest van de trial bij elkaar.
- Boeking aangemaakt, ticketing mislukt. Kan de API een PNR melden die bestaat maar niet geticket is, en vertelt hij je de ticketingdeadline?
- Gedeeltelijke fout. Een hotelaanvraag voor meerdere kamers waarvan er één bevestigt en één niet. Een retourvlucht waarbij heen- en terugreis uit verschillende bronnen komen.
- Annulering buiten de gratis termijn. Wordt de boete gemeld vóór je bevestigt, of ontdek je hem op de factuur?
- Leverancier uit de lucht. Vraag de leverancier hoe je een storing simuleert. Weet hij dat niet, vraag dan hoe zijn klanten erachter kwamen hoe het zich gedraagt.
Per geval scoor je twee dingen. Ten eerste: vertelt de API de waarheid over de staat van de boeking? Ten tweede: kan jouw code op die waarheid handelen zonder dat een mens vrije tekst leest? Met een API die duidelijk faalt, valt beter te leven dan met een die dubbelzinnig slaagt.
Over de vluchtenkant schreven we uitgebreider in wat de documentatie van vluchtboekings-API's weglaat, en over het ontwerpen van een client voor trage hotelleveranciers in het stuk over hotelbeschikbaarheid. Beide passen goed naast een trialplan.
Vragen die een dunne aggregator ontmaskeren
Er is niets mis met een aggregator. De meeste reiscontent bereikt de meeste verkopers via zo'n partij. Het risico zit in de dunne variant: een laag die de API van een andere laag doorverkoopt, er een marge op zet en noch het leverancierscontract noch de operationele desk bezit. Als er iets breekt, moet het antwoord twee bedrijven stroomopwaarts reizen en weer terug.
Vijf vragen brengen dit snel naar boven:
- Wie is de contractuele leverancier van deze boeking? Op wiens contract met de maatschappij of het hotel rust ze?
- Via wiens IATA-nummer en BSP loopt het ticket? Is het antwoord „van een partner”, vraag dan wie de ADM ontvangt als een tariefregel wordt geschonden.
- Wat gebeurt er aan jullie kant als ik cancel aanroep? Een geautomatiseerde aanroep naar de leverancier, of een wachtrij die iemand oppakt?
- Kan ik de fout van stroomopwaarts zien? Een dunne laag drukt elke fout vaak plat tot één code, omdat hij de fouten die hij ontvangt niet volledig begrijpt.
- Wie bel ik over een vastgelopen live boeking, en wie bellen zij? Tel de schakels.
Geen van die antwoorden is op zichzelf diskwalificerend. Het IATA-nummer van een partner kan prima zijn als het contract duidelijk zegt wie de debetnota draagt. Waar het om gaat, is dat de leverancier precies en snel antwoordt. Vage antwoorden nu zijn de antwoorden die je straks krijgt, in productie, op een slechter tijdstip.
Wat een verkeerde keuze je kost
De integratie is het goedkope deel. De dure delen komen later en staan in geen enkele begroting.
Een bug met dubbele boekingen betekent een klant die twee keer is belast en een PNR die je met de hand moet vinden en annuleren, misschien nadat de gratis void-termijn al voorbij is. Een boeking die stroomopwaarts slaagde terwijl jouw kant een fout registreerde, betekent een vastgehouden stoel, daarna een automatische annulering, en een klant die denkt dat hij geboekt is. Een carrier die je toonde maar niet kon ticketen, betekent een terugbetaling, een excuus en een klant die niet terugkomt. Een ADM voor een tariefregel die de route van de leverancier schond, belandt bij wie het ticket bezit — zorg dat je vooraf weet of jij dat bent.
Dan is er de overstapkost. Elke eigenaardigheid van de leverancier die je opvangt — een statuscode die twee dingen betekent, een veld dat soms een string is — belandt in je datamodel. Twee jaar later is de keuze voor de API geen integratie meer die je in een sprint vervangt; het is de vorm van je boekingstabel. Dat is de echte reden om nu zorgvuldig te vergelijken.
Hoe onze eigen API in dit kader past
Wij bieden API's voor vluchten en hotels. Toegang begint met een gesprek en niet met een self-service-sleutel, wat sommige developers traag vinden; de reden is dat in dat gesprek de vragen hierboven in beide richtingen worden gesteld — welke routes en steden je nodig hebt, welke content je werkelijk kunt ticketen of bevestigen, en wie wat afhandelt na de boeking. Doe je een vergelijking, neem deze lijst dan mee. Op de pagina over reis-API's begint dat gesprek.
Wat je ook kiest, kies het op basis van het triallogboek en niet van de presentatie. De presentatie vertelt je wat een leverancier wil zijn. De foutpaden vertellen je wat hij is.