Gratis hotelboekings-API: wat gratis je echt oplevert

Het is donderdagmiddag en de demo is maandag. Je vond een gratis hotelboekings-API, meldde je aan met een e-mailadres en had binnen vijf minuten een sleutel. Het zoek-endpoint geeft hotels terug met foto's, sterren en een prijs per nacht. Tegen de avond ziet de resultatenpagina er precies goed uit. Vrijdag koppel je de boekingscall en die antwoordt met een foutmelding die je niet kunt lezen, omdat waar je je voor aanmeldde nooit een boeking kon maken.
Niemand heeft tegen je gelogen. "Gratis" hangt in deze markt gewoon aan vier verschillende producten, en de aanmeldpagina's vertellen niet welke je in handen hebt.
Vier dingen die "gratis" kan betekenen
Deze tabel is het waard om naast het toetsenbord te houden. Ben het oneens met een rij als jouw leverancier het anders doet; ook dat is een nuttige bevinding.
| Wat het gratis aanbod is | Wat je krijgt | Wat je kunt bouwen | Wat het niet kan |
|---|---|---|---|
| Statische content of directorydata | Hotelnamen, adressen, foto's, faciliteiten, beschrijvingen | Een hotelgids, een kaart, een bestemmingspagina | Een prijs tonen die je kunt waarmaken, of een kamer die op jouw data echt vrij is |
| Affiliate-zoekopdracht met doorverwijzing | Hotels en prijzen, plus een link naar de eigen checkout van de verkoper | Een vergelijkingspagina die het verkeer wegstuurt | De klant, de betaling of het boekingsrecord aan jouw kant houden |
| Sandbox met testtarieven | De volledige calls voor zoeken, prijs, boeken en annuleren, met verzonnen voorraad | Een werkende integratie en een demo die zich als productie gedraagt | Een reservering maken die een echt hotel honoreert |
| Live boekbare tarieven | Echte kamers tegen echte net- of verkoopprijzen, bevestigd door de leverancier | Een winkel die geld ontvangt voor kamers | Gratis zijn voor wie het contract tekent |
De eerste drie zijn gratis omdat weggeven de aanbieder bijna niets kost. De vierde is niet gratis, omdat iemand iets echts draagt.
Waarom een boekbaar tarief altijd met een contract komt
Zodra je klant voor een kamer betaalt, begint een keten van verplichtingen. Een leverancier heeft het contract met het hotel. Die leverancier heeft het hotel beloofd dat de kamer betaald wordt, en jou beloofd dat de kamer bestaat. Annuleert de gast na de gratis annuleringsdatum, dan is iemand het hotel een nacht schuldig. Was het tarief fout, dan vangt iemand het verschil op. Was de kaart gestolen, dan zit iemand met de chargeback.
Dat moet allemaal bij een partij met een naam terechtkomen. Een API-sleutel die iedereen met een e-mailadres kan aanmaken kan dat niet dragen, en daarom komt boekbare toegang met een overeenkomst, een afrekenregeling en vaak een kredietlimiet. De prijs die je betaalt voor de "gratis" sleutel is dat het de aanbieder niet hoeft te kunnen schelen wat je ermee doet.
Dit is geen kritiek op gratis abonnementen. Een contentfeed is precies goed voor een bestemmingsgids. Hij is alleen verkeerd als hij wordt aangezien voor wat je nodig hebt om een boeking aan te nemen.
Als je ook beslist hoeveel leveranciers je nodig hebt achter degene die je kiest, dat bespraken we in hoeveel hotel-API-leveranciers heb je nodig; de vluchtenkant van dezelfde verwarring staat in de drie soorten gratis vlucht-API.
Er zit nog een valkuil in de eerste rij. Statische content en live tarieven zijn twee feeds met een verschillende levensduur: de beschrijving van een hotel kan weken in je cache staan, een tarief voor vannacht kan daar geen minuten staan. Een gratis contentfeed die ook een prijs toont, noemt een getal waar hij niet voor instaat, en een pagina die erop gebouwd is, toont vrolijk een kamer die gisteren is verkocht.
Wat je in een sandbox test voordat er een contract wordt getekend
Een sandbox is het nuttigste gratis ding in de tabel, dus gebruik hem stevig. Een goede sandbox laat je elke stap van een echte boeking doen, met voorraad die nep is maar de vorm heeft van de echte.
- Zoek met kinderen en meerdere kamers. Bezetting is waar eenvoudige integraties het eerst breken. Vraag twee kamers met verschillende gasten en kijk of het antwoord ze uit elkaar houdt.
- Prijscheck voor je boekt. Veel leveranciers verwachten een tweede call die bevestigt dat het tarief nog geldig is. Heeft de sandbox die stap niet, vraag dan of productie hem wel heeft.
- Boek, en lees dan wat er terugkomt. Een bevestigde kamer, een openstaand verzoek en een on-request kamer zijn drie verschillende uitkomsten, en je scherm moet zeggen welke.
- Verander het tarief tussen zoeken en boeken. Tarieven bewegen. Hoe ziet de fout eruit, en kan je code de klant de nieuwe prijs tonen in plaats van een lege pagina?
- Annuleer binnen en buiten de gratis periode. Het annuleringsbeleid hoort als gestructureerde data met data en bedragen binnen te komen, niet als alinea die je moet parsen.
- Faal met opzet. Stuur een foute datum, een onbekende hotelcode, een verlopen token. Tel hoeveel verschillende vormen van foutmeldingen je terugkrijgt.
Kan de sandbox stap vier en vijf niet, dan heb je een content-API met een URL die op boeken lijkt.
Wat bouwen op de verkeerde soort kost
De dure versie van deze fout is niet de week die je kwijt bent. Het is de demo die goed gaat.
Je laat een beslisser een strakke zoekpagina zien, die keurt het budget goed, en pas dan ontdekt het team dat de bron erachter geen kamer kan bevestigen. De code is niet helemaal weggegooid, maar de boekingsflow, de betaalstap, de afhandeling van annuleringen en de afrekening moeten allemaal tegen een andere leverancier met andere veldnamen worden gebouwd. De zoekpagina die je liet zien geeft dan andere hotels terug, tegen andere prijzen, in een andere volgorde. Wie het budget goedkeurde, merkt het.
De goedkopere gewoonte is één vraag stellen voordat je code schrijft: "Kan deze sleutel een reservering maken die een hotel honoreert, en die daarna annuleren?" Is het antwoord iets anders dan ja, dan weet je welke van de vier je vasthoudt.
Waar dit platform staat
We moeten over onze eigen positie net zo duidelijk zijn als over de andere. Het platform biedt API's voor vluchten en hotels, en toegang begint met een gesprek, niet met een selfservice-sleutel. Dat is de vierde rij van de tabel: achter boekbare voorraad staat iemand die moet weten wie er vraagt. Wil je zien hoe het werkt voor wat jij bouwt, begin bij de pagina met reis-API's en vertel ons wat je bouwt.
Gratis content, affiliate-links en sandboxes hebben allemaal hun plek, en de juiste hangt af van wat je wilt verkopen. Kies op wat de sleutel kan op de dag dat een klant betaalt.