Bouw je eigen verhuurwinkel op de Be-Bookable API
In het kort
- Je ontwikkelaar bouwt je eigen webshop of boekingsflow, in je eigen ontwerp. Be-Bookable levert de producten, beschikbaarheid, prijzen en checkout.
- Je eigen systemen lezen je bestellingen met een API-token, en webhooks melden het als een bestelling binnenkomt, betaald is of van status verandert.
- De API zit in elk Be-Bookable-abonnement, zonder meerprijs. Je ontwikkelaar bouwt en test op een sandbox met testbetalingen.
Waarom bouwen op de Be-Bookable API
Met twee regels code zet de Websitewidget een kant-en-klare verhuurwinkel op je site. Sommige verhuurbedrijven willen meer: een boekingsflow in hun eigen ontwerp, of bestellingen die direct in hun eigen systemen komen. Met de API bouwt je ontwikkelaar precies dat, en Be-Bookable blijft het lastige deel doen: beschikbaarheid, prijzen, btw, borg en betaling.
Wij rekenen, jij ontwerpt
Beschikbaarheid, prijzen, btw, verzending, borg en betaling komen van Be-Bookable. Je webshop toont alleen de uitkomst, dus die klopt altijd met je voorraad en prijzen.
Bestellingen in je eigen systemen
Een script, Zapier of Make leest je bestellingen met een API-token, inclusief klantgegevens. Webhooks sturen een ondertekend bericht als een bestelling binnenkomt, betaald is of van status verandert.
Veilig bouwen en testen
Je ontwikkelaar bouwt op een sandbox met testbetalingen, naast een werkende voorbeeldshop. Versie 1 krijgt er alleen dingen bij, dus je webshop blijft werken als de API groeit.
Zo bouw je je eigen webshop op de API
- Zet API-toegang aan. Ga in de Be-Bookable-app naar Integraties en open de kaart API-toegang. Voeg het domein van je eigen webshop toe, bijvoorbeeld
shop.example.com, en de terugkeer-URL voor na de betaling. Zet hem daarna aan. - Bouw op de sandbox. Je ontwikkelaar begint met de handleiding Build your own shop, met een werkende voorbeeldshop. De sandbox op
https://test.api.be-bookable.com/v1accepteert testbetalingen en heeft een testwinkel, dus elke stap is uit te proberen zonder echte bestellingen. - Laat Be-Bookable de boeking doen. Je webshop toont de catalogus, controleert de beschikbaarheid en vraagt Be-Bookable om het totaal. Daarna maakt hij de bestelling aan en stuurt de klant naar de betaalpagina. Na de betaling komt de klant op je terugkeer-URL.
- Koppel je eigen systemen. Open de kaart Bestellingen-API & webhooks. Maak een API-token voor elk programma en voeg de URL van je webhook toe. Testbericht sturen laat direct zien of je server het bericht ontvangt. Alleen de eigenaar van de webshop kan dit.
- Ga live. Registreer het domein van je live webshop, verander de basis-URL in
https://api.be-bookable.com/v1en plaats één echte bestelling door de hele flow.
Wat de API dekt
De verzoeken in de volgorde waarin een klant ze gebruikt:
Toegang, limieten en webhooks
- Webshop: geen token. Je webshop stuurt zijn verzoeken vanuit de browser, op de domeinen die je hebt geregistreerd. De bestelling die je webshop terugleest, bevat geen persoonsgegevens van je klanten.
- Bestellingen-API: een API-token in de header
Authorization, alleen vanaf je server. Hij leest dezelfde bestellingen die je ziet in Orderbeheer, met klantgegevens. Een webshop kan 10 tokens hebben, en je trekt elk token apart in. - Webhooks: drie gebeurtenissen, ondertekend met HMAC-SHA256:
order.created,order.paid,order.status_changed. Antwoordt je server niet, dan proberen we het opnieuw na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur. Het afleverlog bewaart elk bericht 30 dagen. - Limieten: 120 keer lezen en 10 keer schrijven per minuut per IP-adres, en 600 verzoeken per minuut per token. Een antwoord 429 zegt in Retry-After wanneer je het opnieuw kunt proberen.
- Versies: versie 1 krijgt er alleen dingen bij, zoals nieuwe velden of endpoints. Elke wijziging staat in de API-changelog.
Zie het in actie
Een echt verzoek uit de handleiding: je webshop vraagt het totaal van een winkelwagen en Be-Bookable rekent het uit. Daarna het bericht dat je server krijgt als een bestelling betaald is.
Veelgestelde vragen
Kost de API extra?
Nee. De API zit in elk Be-Bookable-abonnement, zie Prijsmodel. Je betaalt alleen je eigen ontwikkelaar of bureau voor het werk aan je webshop.
Heb ik een ontwikkelaar nodig?
Ja. De API is voor iemand die code schrijft, zoals je eigen ontwikkelaar of een webbureau. Wil je zonder code een verhuurwinkel op je site? Gebruik dan de websitewidget.
Wat is het verschil met de websitewidget?
De websitewidget is een kant-en-klare verhuurwinkel die je met twee regels code op je site zet. Met de API bouwt je ontwikkelaar de webshop zelf, dus het ontwerp en de boekingsflow zijn helemaal van jou. Achter allebei zitten dezelfde producten, beschikbaarheid, prijzen en bestellingen in Be-Bookable.
Wat is het verschil met de AI-assistent?
De AI-assistent is voor jou: je vraagt Claude of ChatGPT naar je webshop en laat hem prijzen, voorraad of openingstijden aanpassen, zonder code. De API is voor de software die je ontwikkelaar bouwt: een webshop voor je klanten en koppelingen met je eigen systemen.
Kunnen we testen zonder echte bestellingen?
Ja. De sandbox op https://test.api.be-bookable.com/v1 accepteert testbetalingen, en de voorbeeldshop laat er een volledige bestelling op zien. Voor webhooks stuurt Testbericht sturen in de app een testbericht naar je server, ondertekend met je echte secret.
Welke webhooks zijn er?
Drie: order.created als een bestelling binnenkomt, order.paid als de betaling bevestigd is, en order.status_changed als de status van een bestelling verandert. Elk bericht is ondertekend, zodat je server kan controleren dat het van Be-Bookable komt. Zapier en Make kunnen ze ook ontvangen.
Zijn er limieten?
Ja. Per IP-adres: 120 keer lezen en 10 keer schrijven per minuut, met maximaal 10 bestellingen per minuut. Per API-token: 600 verzoeken per minuut. De headers van elk antwoord laten zien hoeveel verzoeken er over zijn.
Kan mijn ontwikkelaar de gegevens van mijn klanten zien?
Alleen met een API-token. De verzoeken van je webshop geven nooit de persoonsgegevens van je klanten. Een API-token leest je bestellingen met klantgegevens, en alleen de eigenaar van de webshop kan er een maken. Een token dat je intrekt, werkt direct niet meer.
Waar staat de documentatie?
Alles staat op developers.be-bookable.com: de handleiding Build your own shop, de volledige referentie van elk verzoek, de voorbeeldshop en de changelog.
