Naar inhoud springen
Blog

Een API voor vliegprijzen: waarom dat getal nog geen tarief is

Tekravel Redactie
Geschreven met hulp van AI

De demo werkt. Een ontwikkelaar koppelt een API voor vliegprijzen aan een kalender met de goedkoopste dagen om te vliegen, het rooster vult zich met getallen en iedereen in de zaal is tevreden. Dan kiest de eerste echte klant een datum, ziet op de resultatenpagina een lager bedrag dan op de betaalpagina en mailt de klantenservice met een screenshot. Er is niets kapot. De API deed precies wat haar werd gevraagd: ze beantwoordde een vraag over prijs, en de site behandelde het antwoord als een belofte.

Een prijs is een aanbod met een kort geheugen

Een tarief van een luchtvaartmaatschappij is geen vast label op een stoel. Het is een klasse die opengaat en dichtgaat naarmate stoelen verkocht worden, en het getal erbij verandert met de samenstelling van de passagiers, de exacte vluchten, de belastingen van de betrokken luchthavens en de valuta waarin de offerte staat. Een prijsantwoord is een momentopname, gemaakt op één moment voor één set invoer. Behandel het als een feit over het verleden en je bouwt het juiste; behandel het als een feit over het heden en je bent een maand bezig met terugbetalingen.

De nuttige vraag voor een ontwikkelaar is dus nooit alleen wat de prijs is. Het is wat voor soort prijs het is, hoe oud hij is en wat het systeem doet als hij onjuist blijkt.

Drie getallen die allemaal prijs heten

De meeste aanbieders geven alle drie ergens in hun documentatie terug, vaak onder dezelfde veldnaam. Houd ze vanaf dag één gescheiden in je eigen datamodel.

StatusWaar het vandaan komtHoe versKun je het verkopen?Wat toon je
BladerprijsGecachete of geaggregeerde zoekopdracht, gebouwd voor snelheid en breedteMogelijk verouderd en niet berekend voor jouw passagiersNeeDe tekst «vanaf» en een melding dat het kan wijzigen
Geprijsd aanbodLive verzoek voor de exacte reisroute, passagierstypen en tariefVers op het moment van de aanroep, met vervaltijd of herprijssignaalJa, tot het verlooptHet totaal, belastingen uitgesplitst, tariefvoorwaarden
Uitgegeven bedragWat de maatschappij of het uitgiftesysteem daadwerkelijk heeft afgeschreven bij de orderDefinitiefAl verkochtHet betalingsbewijs; afstemmen met het aanbod

De bladerprijs maakt kalenders en «goedkoopst vanaf»-badges mogelijk, en dat is een prima ding om te bouwen. Het is alleen niet hetzelfde object als de tweede rij. De fout is één veld met de naam price waar alle drie in stromen.

In de praktijk betekent dit drie aparte typen of tabellen in je code, niet één met een vlag. Een bladerprijs mag een beetje fout zijn, omdat het slechts een aanzet is om te klikken. Een geprijsd aanbod is een verbintenis die je op eigen naam aangaat, dus het wordt bewaard met het tijdstip van ophalen, de invoer die het opleverde en de identificatie die de aanbieder bij het bestellen terug wil. Het uitgegeven bedrag is boekhouding. Als de klantenservice vraagt waarom een klant een ander bedrag betaalde dan in een e-mail stond, zit het antwoord in het verschil tussen de rijen, en dat verschil lees je alleen als je alle drie bewaard hebt.

Wat een prijsantwoord moet bevatten

Een kaal getal is niet genoeg om een checkout op te bouwen. Zoek bij het lezen van het voorbeeldantwoord van een aanbieder naar het volgende, en wees achterdochtig bij alles wat als vrije tekst binnenkomt.

  • De valuta, vermeld in het antwoord en niet aangenomen vanuit je account.
  • Basistarief en belastingen apart, zodat je een specificatie kunt tonen en een belastingwijziging niet op een tariefwijziging lijkt.
  • De passagierstypen waarvoor de prijs is berekend. Een volwassenenprijs maal drie is geen gezinstarief.
  • Tariefvoorwaarden en bagage als gestructureerde data, want die bepalen of een goedkope optie voor je klant echt goedkoper is.
  • Een vervaltijd of herprijssignaal: een tijdstempel, of de uitdrukkelijke melding dat je opnieuw moet prijzen vóór het bestellen.

Dat laatste punt slaat bijna iedereen over. Als nergens in het antwoord staat hoe lang het aanbod leeft, raad je, en die gok wordt in productie gedaan.

Prijs opnieuw vóór de order, niet erna

Het veiligste ritme bevat een regel. Zoek om te bladeren. Kiest de klant een reisroute, vraag dan een live geprijsd aanbod voor precies die route en die passagiers. Toon de klant dat totaal. Maak pas dan de order aan. Wijkt de live prijs af van die op de resultatenpagina, dan zeg je dat vóór de betaling, in gewone woorden, in plaats van erna.

Sla je de middelste stap over, dan erf je het verschil. Of je rekent meer dan de klant zag en verliest de verkoop op de betaalpagina, of je honoreert het lagere getal en het verschil gaat van je eigen marge af. Een klein reisbureau kan dat een paar keer opvangen; als ontwerp niet.

Vraag dit schriftelijk voordat je integreert

Documentatie beschrijft het gelukkige pad. Het gedrag dat je geld kost zit in de antwoorden op een korte lijst vragen, en die antwoorden heb je liever in een e-mail dan in een telefoongesprek.

  1. Is de prijs in het zoekantwoord live of gecachet, en staat dat in het antwoord zelf?
  2. Is er een aparte prijsaanroep voor de exacte reisroute, en is die verplicht vóór een order?
  3. Wat gebeurt er bij het bestellen als de prijs is verschoven: een weigering, een nieuwe prijs in het antwoord of een stille uitgifte tegen het nieuwe bedrag?
  4. Hoe worden belastingen en toeslagen van de maatschappij uitgesplitst, en kunnen ze veranderen tussen prijzen en uitgeven?
  5. In welke valuta wordt de prijs berekend, en waar gebeurt de omrekening als de klant een andere ziet?
  6. Hoe lang blijft een geprijsd aanbod geldig, en hoe merk je dat?

Een aanbieder die dit nauwkeurig beantwoordt, heeft over de checkout nagedacht. Eén die zegt «het is altijd actueel» heeft je niets verteld wat je kunt testen. Als je het gedrag niet zelf kunt uitproberen, is dat een reden om de hele stack anders te bekijken voordat je ervoor gaat bouwen.

Wat het kost als het misgaat

Het faalt zelden luidruchtig. Het faalt als een kleine daling bij de betaalstap die niemand aan de prijs wijt, als supporttickets die beginnen met «de prijs is veranderd», als een klant die de resultatenpagina vertrouwde en nu niet meer. Medewerkers bevestigen uiteindelijk tarieven met de hand vóór het uitgeven. Iemand stelt uiteindelijk een regel voor die prijzen voor de zekerheid naar boven afrondt, en dan is de site duur op het ene scherm waar mensen vergelijken. Elk daarvan is een belasting op een beslissing die aan het begin goedkoop goed te nemen was.

Waar dit platform staat

Het platform biedt vlucht- en hotel-API's, per tenant geactiveerd. Toegang begint met een gesprek in plaats van een self-service sleutel, dus er is geen aanmeldformulier dat je een token en een limietentabel geeft. Deze pagina publiceert geen latentie, dekking of aantallen tarieven, want een getal waarvan we niet kunnen laten zien hoe je het test, is het drukken niet waard. Wat je wel kunt doen: de vragen hierboven in dat gesprek inbrengen en vragen om het antwoord voor een geprijsd aanbod te zien, niet alleen voor een zoekopdracht. Zit je in die fase, dan begint het op de pagina over reis-API's.

Tekravel Redactie

Desk reistechnologie

De reistechnologie-desk van Tekravel schrijft voor de branche: eigenaren van reisbureaus, consolidators en de ontwikkelaars die hen koppelen. Elk artikel wordt vóór publicatie getoetst aan het platform dat het beschrijft.