Gebruik actuele Eguide-data in je eigen website
Haal je rondleidingen, events, referentiegegevens, beschikbaarheid en prijzen op vanuit Eguide. Laat bezoekers hun keuze maken en stuur hen daarna veilig door naar de Eguide-bookingflow.
Toon je Eguide-aanbod in een eigen website
Wil je bezoekers op je eigen website laten zoeken tussen rondleidingen en events? Dan wil je niet dezelfde titels, locaties, talen en prijzen opnieuw in een afzonderlijk beheersysteem invoeren.
Met de API haalt je website die gegevens rechtstreeks uit Eguide op. Zo kan je een eigen aanbodpagina, zoekfunctie of selectie-ervaring bouwen op basis van de informatie die je organisatie al beheert.
De API is standaard onderdeel van iedere Eguide-omgeving. Ze is bedoeld voor externe websites en toepassingen die aanbod willen tonen en bezoekers naar een geldige boekingsingang willen begeleiden.
Heb je geen eigen integratie nodig, dan kan je met een rechtstreekse link eenvoudiger naar één rondleiding of event verwijzen.
Bouw een selectie die bij je bezoekers past
De API geeft toegang tot de gegevens waarmee je bezoekers gericht door je aanbod kunt laten zoeken.
Je website kan onder meer steden, locaties, talen, tagcategorieën en tags gebruiken. Daarmee bouw je bijvoorbeeld een overzicht van Nederlandstalige rondleidingen in één stad of een selectie van activiteiten rond een bepaald thema.
Ook gegevens zoals de duur, ontmoetingsplaats, eindlocatie, groepsgrenzen en publicatiestatus kunnen bij een rondleiding beschikbaar zijn.
De gebruikte steden, locaties en classificaties komen uit de centrale referentiegegevens die je binnen Eguide onderhoudt. Zo gebruikt je website dezelfde benamingen als je interne aanbod.
Gebruik vertalingen waar je website ze nodig heeft
Verschillende API-responses bevatten vertaalde gegevens. Daardoor kan een meertalige website de passende titel, locatie of omschrijving tonen zonder daarvoor een aparte productdatabase op te bouwen.
De API voert zelf geen automatische vertaling uit. Je website gebruikt de taalversies die eerder in Eguide zijn vastgelegd. Meer daarover lees je bij het beheren van meerdere klant- en werktalen binnen dezelfde omgeving.
Bekijk wat je website uit Eguide kan gebruiken
We bespreken je gewenste selectie en boekingsroute.
Toon beschikbare momenten en passende prijzen
Een mooie aanbodpagina alleen is niet voldoende. Bezoekers willen ook weten wanneer ze kunnen boeken en welke prijs bij hun keuze hoort.
Voor privérondleidingen kan je website boekbare opties, tijdstippen, prijzen en geldige groepsgroottes ophalen. Voor events kan ze per moment tonen of het nog boekbaar is en hoeveel plaatsen er beschikbaar zijn.
Zo kan een bezoeker al op je eigen website een rondleiding, event, datum of tijdstip selecteren.
De API gebruikt daarbij de beschikbaarheid en prijzen die in Eguide zijn ingesteld. Je hoeft dezelfde regels dus niet opnieuw in de websitecode te onderhouden.
Geef de gekozen optie veilig door
Zodra de bezoeker een geldige keuze heeft gemaakt, vraagt je website een ondertekende link aan.
Die link brengt de gekozen rondleiding of het event, samen met de geselecteerde datum en tijd, naar de Eguide-bookingflow. De klant hoeft zijn keuze daar niet opnieuw te maken en kan meteen verder met de gegevens die nog ontbreken.
De ondertekende overdracht voorkomt dat de website zelf een volledige boeking of checkout hoeft op te bouwen.
Laat klantgegevens en checkout in Eguide
De API maakt geen volledige boeking aan. Ze verstuurt ook geen klant-, groeps-, ticket-, facturatie- of betaalgegevens.
Na de overdracht vult de klant die informatie in binnen [de online bookingflow van Eguide. Wanneer online betaling is ingeschakeld, gebeurt de betaling vervolgens in Mollie.
Dat houdt de verantwoordelijkheid van je eigen website overzichtelijk. Je integratie toont het aanbod, helpt bij de selectie en geeft die keuze veilig door. Eguide verwerkt daarna de aanvraag en de verdere opvolging.
Gebruik de API niet als externe beheeromgeving
API v1 bevat geen functies om boekingen, klanten, voorstellen, betalingen, facturen, gidsen of rapporten extern te beheren.
Er zijn ook geen publieke webhooks of callbacks gedocumenteerd waarmee je website automatisch iedere latere wijziging uit Eguide ontvangt.
De API past daarom vooral bij een lees- en doorstuurmodel: je gebruikt actuele gegevens om bezoekers te laten kiezen, maar de eigenlijke boeking en operationele verwerking blijven in Eguide.
Veelgestelde vragen over de API
Praktische antwoorden over je integratie.
De Public API publiceert onder meer steden, locaties, talen, tagcategorieën, tags, privérondleidingen en events.
Afhankelijk van het type aanbod zijn ook gegevens zoals prijzen, groepsgrenzen, beschikbare tijdstippen en resterende eventplaatsen beschikbaar.
Nee. De Public API ondersteunt de selectie van aanbod, datum en tijdstip, maar is geen volledige headless checkout.
De verdere gegevensinvoer en checkout vinden plaats in de Eguide-bookingflow. Eventuele online betaling gebeurt in Mollie.
Nee. De booking-request-endpoints leveren een ondertekende URL waarmee de klant naar de juiste Eguide-bookingflow wordt doorgestuurd.
De eigenlijke boeking ontstaat pas nadat de klant daar de benodigde gegevens heeft ingevuld en de flow heeft afgerond.
Nee. De Public API bevat geen functies voor het beheren van boekingen, klanten, voorstellen, betalingen, facturen, gidsen of rapporten.
Die opvolging gebeurt in de centrale Eguide-omgeving.
Nee. In Public API v1 zijn geen publieke webhooks of callbacks gedocumenteerd.
De API is bedoeld om gegevens uit te lezen en een gekozen optie veilig aan de Eguide-bookingflow door te geven.
Ja. De Public API is standaard onderdeel van iedere Eguide-omgeving.
Een eigen integratie moet wel door je websitebouwer of integratiepartner worden ontwikkeld. Een volledig geïntegreerde Eguide-website blijft een afzonderlijke dienst.
Staat je vraag er niet tussen? Neem contact met ons op. We bekijken graag wat je website via de Public API kan gebruiken.