KoppelingenRecras
Recras API koppelen aan je website.
Recras is het boekings- en administratiesysteem van recreatiebedrijven: escaperooms, klimparken, botenverhuur, trampolineparken en evenementenlocaties. Wij zetten je arrangementen als eigen pagina’s op je site en laten het boeken via Recras lopen, zodat je gevonden wordt op wat je aanbiedt.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Recras je oplevert.
Een eigen pagina per arrangement. Elk arrangement krijgt een eigen adres op je domein, met je eigen tekst en beeld erbij.
Boeken zonder je site te verlaten. De klant kiest datum, aantal personen en extra’s en rekent af, allemaal binnen je eigen pagina.
Eén administratie. De boeking staat meteen in Recras, dus planning, factuur en klantcontact lopen zoals je gewend bent.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- REST met JSON, en een JavaScript-bibliotheek die het boekproces in je eigen pagina zet
- Authenticatie
- API-sleutel uit Recras als Bearer-token; de bibliotheek werkt zonder sleutel
- Richting
- Beide kanten op
- Verversing
- Beschikbaarheid bij de aanvraag, wijzigingen via webhooks
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- Er zijn drie manieren en de keuze bepaalt alles wat erna komt. De WordPress-plugin en een openbare Recras-pagina in een iframe zijn binnen een middag klaar. De API kost meer, maar levert het enige op wat de andere twee niet kunnen: je arrangementen als eigen pagina’s op je eigen domein. Maak die keuze aan het begin, want achteraf omzetten is opnieuw bouwen.
- De JavaScript-bibliotheek draait in de browser en heeft alleen de naam van je Recras nodig, geen sleutel. Dat is handig en precies daarom belangrijk: je API-sleutel hoort daar nooit bij te staan. Met die sleutel kun je bij contacten, facturen en boekingen, dus hij blijft aan de serverkant en komt niet in je paginabron of je repository terecht.
- Beschikbaarheid is het lastige deel van deze koppeling. Recras heeft aparte endpoints voor de beschikbaarheid van arrangementen en van producten, en die verandert de hele dag. Bewaar je het te lang, dan kiest iemand een tijdslot dat net vol zit; bewaar je niets, dan gaat elke paginaweergave langs Recras. Wij bewaren de arrangementen zelf en vragen de beschikbaarheid pas op in de stap waar hij telt.
- Een boekproces in een iframe staat naast je site en niet erin. Voor het boeken zelf maakt dat weinig uit, maar er is dan geen eigen adres per arrangement, geen eigen titel en niets wat een zoekmachine kan indexeren. Precies het verkeer waarvoor je de arrangementen online zette, loopt dan langs je heen.
Recras koppelen
Wat je moet weten voor je begint.
Wat is Recras?
Recras is een online boekings- en administratiesysteem voor recreatiebedrijven, van Recras BV in Groningen. Het gaat verder dan reserveren alleen: boekingen, planning, personeelsinzet, facturatie en klantcontact zitten in hetzelfde pakket.
De klanten zijn breed: escaperooms, klimparken, trampolineparken, botenverhuur en rondvaart, watersportbedrijven, musea en attracties, evenementenlocaties en verhuurbedrijven. Volgens Recras werken er ruim driehonderdvijftig organisaties mee en lopen er meer dan zevenhonderdvijftigduizend boekingen per jaar doorheen.
Drie manieren om Recras op je site te zetten
Recras biedt ze alle drie aan en ze zijn geen van drieën fout. Ze verschillen alleen in wat je er later mee kunt.
De WordPress-plugin zet het boekproces in je WordPress-site en is met CSS naar je huisstijl te trekken. Elk boekproces en contactformulier heeft daarnaast een eigen openbare pagina bij Recras, die je in een iframe of achter een link kunt zetten. En er is de API, waarmee je alle onderdelen van het reserveringssysteem zelf in je site bouwt.
Wij bouwen op de API, met de JavaScript-bibliotheek van Recras voor het boekproces zelf. Dat is meer werk, maar het is de enige manier waarop je arrangementen echte pagina’s van jouw site worden in plaats van inhoud die er toevallig in hangt.
Wat de API kan
Meer dan alleen boeken. De documentatie is openbaar en beschrijft onder andere arrangementen en producten, de beschikbaarheid van allebei, boekingen, contacten en klanten, contactformulieren, facturen en betalingen, kortingscodes, tegoedbonnen, diensten en webhooks.
Dat betekent dat een koppeling verder kan gaan dan een knop op een pagina. Een aanvraagformulier op je site kan als contact in Recras belanden, een tegoedbon kan online worden verkocht, en met webhooks krijg je bericht zodra er iets verandert in plaats van dat je site blijft vragen of er al nieuws is.
De sleutel gaat mee als Bearer-token in de header. Een klein deel van de endpoints is openbaar, de rest niet, en dat onderscheid bepaalt wat er in de browser mag draaien en wat aan de serverkant hoort.
Waar de winst zit: eigen pagina’s per arrangement
Hier zit het verschil tussen een site die boekingen aanneemt en een site die boekingen oplevert.
Iemand die een vrijgezellenfeest, een bedrijfsuitje of een dagje uit met de kinderen zoekt, typt dat in met een plaatsnaam erachter. Daar wil je met een pagina staan die over precies dat arrangement gaat: wat het is, voor hoeveel personen, wat het kost, hoe lang het duurt en wat er wel en niet bij zit. Die pagina kun je alleen maken als de arrangementen uit Recras echte pagina’s van jouw site zijn.
Zit het boekproces in een iframe, dan heb je één pagina die "Boeken" heet en verder niets. Het boeken werkt, maar er valt niets te vinden en niets naar te linken. Met de koppeling die wij bouwen krijgt elk arrangement een eigen adres, een eigen titel en een eigen omschrijving, en staat de boekknop daar gewoon op.
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik het boekproces van Recras op mijn eigen website zetten?
Ja, op drie manieren. Er is een WordPress-plugin, elk boekproces heeft een eigen openbare pagina die je in een iframe kunt zetten, en er is de API waarmee je alles zelf inbouwt. Wij bouwen op de API, want alleen dan worden je arrangementen echte pagina’s van je eigen site.
Heeft Recras een API?
Ja, met openbare documentatie. Je kunt er arrangementen, producten, beschikbaarheid, boekingen, contacten, facturen, kortingscodes en tegoedbonnen mee benaderen, en er zijn webhooks voor wijzigingen. De sleutel maak je aan in Recras en gaat mee als Bearer-token.
Waarom niet gewoon de iframe of de WordPress-plugin?
Die werken prima voor het boeken zelf. Alleen krijgt je aanbod dan geen eigen pagina met een eigen adres, en dat is precies waar iemand op zoekt die een bedrijfsuitje of vrijgezellenfeest in jouw omgeving intypt. Gaat het je alleen om de boekknop, dan is de plugin sneller klaar.
Blijft mijn beschikbaarheid kloppen?
Ja, want die vragen we op in de stap waar het telt en niet uit een voorraadje van gisteren. De arrangementen zelf bewaren we wel aan onze kant, zodat de pagina snel laadt. Zo zie je actuele tijden zonder dat elke bezoeker een aanvraag naar Recras veroorzaakt.
Komt een boeking meteen in Recras te staan?
Ja. De boeking wordt via de API in Recras aangemaakt, dus planning, factuur en klantcontact lopen daarna zoals je gewend bent. Je hoeft niets over te nemen uit een mail, en dubbele boekingen op hetzelfde tijdslot worden aan de kant van Recras voorkomen.
Werkt dit ook op WordPress?
Ja. Recras heeft een eigen WordPress-plugin, en daarnaast kunnen wij de API in je WordPress-site bouwen zodat de arrangementen eigen pagina’s worden. Welke van de twee het wordt hangt af van of je vooral wilt kunnen boeken of ook gevonden wilt worden.
Let’s work together.
Je arrangementen als eigen pagina’s, met de boekknop erop.