Welkom! Mogen we cookies gebruiken?

We gebruiken cookies om de website goed te laten werken en om te begrijpen hoe je onze site gebruikt. Zo kunnen we de website blijven verbeteren.

Meer informatie

Cookievoorkeuren

Functionele cookies Verplicht

Nodig voor het goed functioneren van de website, zoals het onthouden van je inloggegevens en voorkeuren.

Analytische cookies

Helpen ons te begrijpen hoe bezoekers de website gebruiken, zodat we deze kunnen verbeteren. We gebruiken hiervoor Google Analytics.

Media cookies

Maken het mogelijk om video's en andere media van externe diensten zoals YouTube te bekijken.

Voor ontwikkelaars

Webhooks en API

Koppel je CRM, tijdregistratie of ledenadministratie. WandelWeb stuurt een ondertekende HTTP-POST bij elke relevante gebeurtenis.

Overzicht

Elke organisatie kan één of meer webhook-URL's registreren in Instellingen → Integraties. Je kiest zelf welke events je ontvangt. Elk bericht heeft een unieke event_id; gebruik die als idempotentiesleutel.

De payloads bevatten persoonsgegevens van deelnemers. Jij bent verwerkingsverantwoordelijke voor wat je opslaat. Bewaar secrets veilig en deel ze niet.

Webhooks

WandelWeb POST een JSON-envelop naar je HTTPS-URL. In lokale ontwikkeling is HTTP toegestaan. Privé- en loopback-adressen worden geweigerd.

Hieronder staat per event een voorbeeldpayload, gegenereerd uit dezelfde resources als de echte leveringen.

order.paid

{ "id": "01EXAMPLEEVENTID0000000000", "type": "order.paid", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "public_id": "01M3NVM1D65F3493W6PJPEBWG7", "status": "paid", "source": "web", "channel": null, "email": "koper@example.test", "first_name": "Anna", "last_name": "de Vries", "phone": "0693201182", "locale": "nl", "totals": { "subtotal_cents": 1000, "discount_cents": 0, "platform_fee_cents": 77, "total_cents": 1093, "currency": "EUR" }, "paid_at": "2026-09-29T05:53:52+00:00", "invoice_number": null, "lines": [ { "description": "Regulier", "quantity": 1, "unit_price_cents": 1250, "total_cents": 1363, "vat_rate": 9 } ], "tickets": [ { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null }, { "public_id": "01M3NVM1DKNVZ1GPXS5V6VG7J6", "ticket_number": "DUIN-000002", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Bert", "last_name": "Jansen", "email": "robb36@example.org", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null } ] } }

order.refunded

{ "id": "01EXAMPLEEVENTID0000000000", "type": "order.refunded", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "id": 9, "order_public_id": "01M3NVM1D65F3493W6PJPEBWG7", "status": "pending", "amount_cents": 1250, "currency": "EUR", "reason": "organiser_decision", "ticket_ids": [], "processed_at": null } }

ticket.issued

{ "id": "01EXAMPLEEVENTID0000000000", "type": "ticket.issued", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null } }

ticket.updated

{ "id": "01EXAMPLEEVENTID0000000000", "type": "ticket.updated", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null } }

ticket.cancelled

{ "id": "01EXAMPLEEVENTID0000000000", "type": "ticket.cancelled", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null } }

ticket.replaced

{ "id": "01EXAMPLEEVENTID0000000000", "type": "ticket.replaced", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "previous_ticket": { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null }, "ticket": { "public_id": "01M3NVM1DKNVZ1GPXS5V6VG7J6", "ticket_number": "DUIN-000002", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Bert", "last_name": "Jansen", "email": "robb36@example.org", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null } } }

ticket.checked_in

{ "id": "01EXAMPLEEVENTID0000000000", "type": "ticket.checked_in", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "id": 3, "ticket_public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "scan_post": { "id": 12, "name": "Start", "type": "check_in" }, "scanned_at": "2026-09-29T05:53:52+00:00", "method": "qr", "result": "valid" } }

event.published

{ "id": "01EXAMPLEEVENTID0000000000", "type": "event.published", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "id": 173, "public_slug": "duinentocht", "title": "Duinentocht", "starts_at": "2026-12-30T09:00:00+00:00", "ends_at": "2026-12-30T22:59:59+00:00", "timezone": "Europe/Amsterdam", "status": "published", "distances": [ { "id": 23, "name": "25 km", "distance_km": 25 } ], "ticket_types": [ { "id": 226, "name": "Regulier", "price_cents": 1250 } ] } }

event.cancelled

{ "id": "01EXAMPLEEVENTID0000000000", "type": "event.cancelled", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "id": 173, "public_slug": "duinentocht", "title": "Duinentocht", "starts_at": "2026-12-30T09:00:00+00:00", "ends_at": "2026-12-30T22:59:59+00:00", "timezone": "Europe/Amsterdam", "status": "published", "distances": [ { "id": 23, "name": "25 km", "distance_km": 25 } ], "ticket_types": [ { "id": 226, "name": "Regulier", "price_cents": 1250 } ] } }

waitlist.entry_created

{ "id": "01EXAMPLEEVENTID0000000000", "type": "waitlist.entry_created", "version": "2026-09-01", "created_at": "2026-09-01T10:00:00+00:00", "organiser": { "id": 311, "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging" }, "event": { "id": 173, "slug": "duinentocht", "title": "Duinentocht" }, "data": { "id": 12, "email": "wacht@example.test", "quantity": 1, "position": 1, "ticket_type": { "id": 226, "name": "Regulier" } } }

Handtekening verifiëren

Elke levering heeft de header X-WandelWeb-Signature in de vorm v1=<hex>. Bereken HMAC-SHA256 over "<timestamp>.<body>" met je webhook-secret en vergelijk in constante tijd. Accepteer alleen timestamps van maximaal vijf minuten verschil.

Gebruik event_id (header X-WandelWeb-Event-Id en veld id in de body) om dubbele leveringen te negeren. Opnieuw versturen houdt dezelfde event_id.

PHP

$timestamp = $_SERVER['HTTP_X_WANDELWEB_TIMESTAMP'] ?? ''; $signature = $_SERVER['HTTP_X_WANDELWEB_SIGNATURE'] ?? ''; $body = file_get_contents('php://input'); if (abs(time() - (int) $timestamp) > 300) { http_response_code(401); exit; } $expected = 'v1='.hash_hmac('sha256', $timestamp.'.'.$body, $secret); if (! hash_equals($expected, $signature)) { http_response_code(401); exit; }

Node.js

const crypto = require('crypto'); const timestamp = req.get('X-WandelWeb-Timestamp'); const signature = req.get('X-WandelWeb-Signature'); const body = req.rawBody; // raw bytes, not parsed JSON if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) { return res.status(401).end(); } const expected = 'v1=' + crypto.createHmac('sha256', secret) .update(`${timestamp}.${body}`) .digest('hex'); if (! crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature))) { return res.status(401).end(); }

Retries en uitschakelen

Een mislukte levering (geen 2xx, timeout, DNS- of TLS-fout) wordt opnieuw geprobeerd na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur. Daarna stopt de levering.

Na twintig opeenvolgende mislukkingen schakelt WandelWeb de webhook uit en mailt de eigenaar en beheerders. Je kunt hem daarna handmatig weer aanzetten.

Privacy

Webhook-payloads bevatten namen, e-mailadressen, telefoonnummers, antwoorden op formulieren en startnummers. De organisator is verwerkingsverantwoordelijke; de ontvanger van de webhook is verantwoordelijk voor beveiligde opslag en retentie.

Secrets staan versleuteld in de database en worden maar één keer getoond. Roteer een secret meteen als het gelekt is.

Lees-API met API-sleutels

Met de lees-API halen je eigen systemen evenementen, tickettypes, bestellingen, tickets, check-ins en statistieken op. De API is alleen-lezen: wijzigen kan alleen in WandelWeb zelf.

Een eigenaar of beheerder maakt een API-sleutel aan onder Instellingen → Integraties. De sleutel hoort bij de organisatie, niet bij een persoon, en werkt dus door als iemand het team verlaat. Je ziet de sleutel maar één keer; daarna alleen de laatste vier tekens. Geef een sleutel een verloopdatum en trek hem direct in als hij gelekt is.

Stuur de sleutel mee als Authorization: Bearer <sleutel>. Elke URL begint met /api/organiser/v1/organisers/{slug}; een sleutel werkt alleen voor zijn eigen organisatie. Antwoorden zijn JSON met data, links en meta; lijsten zijn gepagineerd met page en per_page (standaard 50, maximaal 200). Tijden zijn ISO 8601 in UTC, bedragen in centen.

Synchroniseren doe je met updated_since (bestellingen en tickets, oudste wijziging eerst). Per sleutel mag je 300 verzoeken per minuut doen; daarboven krijg je 429 met een Retry-After-header. Combineer de API met webhooks voor realtime updates.

Versiebeleid: binnen v1 komen er alleen velden bij; er verdwijnt of hernoemt nooit iets. Negeer onbekende velden. Een breuk krijgt een nieuwe versie (/v2). Elk antwoord heeft de header X-WandelWeb-Api-Version.

Privacy: antwoorden bevatten namen, e-mailadressen, telefoonnummers, formulierantwoorden en startnummers. De organisator is verwerkingsverantwoordelijke; bewaar deze gegevens beveiligd en niet langer dan nodig. Antwoorden hebben Cache-Control: no-store.

Endpoints

GET /
Gegevens van de organisatie.
GET /events
Evenementen met ticketing. Filters: status[], from, to.
GET /events/{id}
Eén evenement met afstanden, tickettypes en kerncijfers.
GET /events/{id}/ticket-types
Tickettypes met prijs, capaciteit en verkocht.
GET /events/{id}/orders
Bestellingen. Filters: status[], updated_since, email.
GET /orders/{public_id}
Eén bestelling met regels en tickets.
GET /events/{id}/tickets
Tickets (standaard geldig). Filters: status[], ticket_type_id, distance_id, bib_number, search, updated_since.
GET /tickets/{public_id}
Eén ticket met check-ins.
GET /events/{id}/check-ins
Scans, nieuwste eerst. Filters: scan_post_id, since, result.
GET /events/{id}/stats
Verkoop- en check-in-tellers.
GET /webhooks
Je webhooks, zonder secrets.

Voorbeeld

curl -H "Authorization: Bearer <api-key>" \ -H "Accept: application/json" \ "https://wandelweb.nl/api/organiser/v1/organisers/voorbeeld-wandelvereniging/events/123/tickets?updated_since=2026-09-01T00:00:00Z&per_page=200"

Foutcodes

401
Geen, onbekende, verlopen of ingetrokken sleutel.
403
Sleutel zonder leesrecht, organisatie geblokkeerd of API uitgezet door WandelWeb.
404
Onbekende of andere organisatie, of een object dat niet bij deze organisatie hoort.
422
Ongeldige filterwaarde.
429
Te veel verzoeken; wacht het aantal seconden uit Retry-After.

Voorbeeldantwoorden. Bij lijsten is data een array en komen links en meta erbij.

GET /

{ "data": { "id": 311, "slug": "voorbeeld-wandelvereniging", "name": "Voorbeeld Wandelvereniging", "website": "https://nicolas.com/nostrum-et-sit-iure-quisquam.html", "timezone": "Europe/Amsterdam", "api_version": "1" } }

GET /events/{id}/ticket-types

{ "data": { "id": 226, "name": "Regulier", "description": "", "distance_id": null, "price_cents": 1250, "current_price_cents": 1250, "vat_rate": 9, "currency": "EUR", "fee_paid_by": "buyer", "visibility": "public", "capacity": null, "sold_count": 0, "reserved_count": 0, "available": null, "min_per_order": 1, "max_per_order": 10, "sales_start_at": null, "sales_end_at": null, "sort_order": 0 } }

GET /orders/{public_id}

{ "data": { "public_id": "01M3NVM1D65F3493W6PJPEBWG7", "status": "paid", "source": "web", "channel": null, "email": "koper@example.test", "first_name": "Anna", "last_name": "de Vries", "phone": "0693201182", "locale": "nl", "totals": { "subtotal_cents": 1000, "discount_cents": 0, "platform_fee_cents": 77, "total_cents": 1093, "currency": "EUR" }, "paid_at": "2026-09-29T05:53:52+00:00", "invoice_number": null, "lines": [ { "description": "Regulier", "quantity": 1, "unit_price_cents": 1250, "total_cents": 1363, "vat_rate": 9 } ], "tickets": [ { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null }, { "public_id": "01M3NVM1DKNVZ1GPXS5V6VG7J6", "ticket_number": "DUIN-000002", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Bert", "last_name": "Jansen", "email": "robb36@example.org", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null } ], "created_at": "2026-09-29T05:53:52+00:00", "updated_at": "2026-09-29T05:53:52+00:00" } }

GET /tickets/{public_id}

{ "data": { "public_id": "01M3NVM1DCQ7Y6TEKJK5MJWFT9", "ticket_number": "DUIN-000001", "status": "valid", "ticket_type": { "id": 226, "name": "Regulier" }, "distance": null, "holder": { "first_name": "Anna", "last_name": "de Vries", "email": "anna@example.test", "phone": null, "date_of_birth": null, "gender": null, "city": null }, "emergency_contact": null, "answers": [], "bib_number": null, "time_slot": null, "wave": null, "team": null, "check_ins": [ { "id": 3, "scan_post_id": 12, "scan_post_name": "Start", "scanned_at": "2026-09-29T05:53:52+00:00", "result": "valid" } ], "progress": { "status": "on_course", "started_at": "2026-09-29T05:53:52+00:00", "last_seen": { "scan_post_id": 12, "scan_post_name": "Start", "scanned_at": "2026-09-29T05:53:52+00:00" }, "finished_at": null, "is_overdue": false }, "updated_at": "2026-09-29T05:53:52+00:00" } }

GET /events/{id}/stats

{ "data": { "event_id": 173, "sales": { "sold": 0, "reserved": 0, "capacity": null, "per_ticket_type": [ { "ticket_type_id": 226, "name": "Regulier", "sold": 0, "reserved": 0, "capacity": null, "available": null } ], "per_distance": [ { "distance_id": 23, "name": "25 km", "sold": 0, "reserved": 0, "capacity": null, "available": null } ] }, "check_ins": { "expected": 2, "checked_in": 1, "last_scan_at": "2026-09-29T05:53:52+00:00", "per_scan_post": [ { "scan_post_id": 12, "name": "Start", "type": "check_in", "is_active": true, "valid": 1, "already_scanned": 0, "invalid": 0 } ], "per_distance": [ { "distance_id": 23, "name": "25 km", "expected": 0, "checked_in": 0, "progress": { "not_started": 0, "on_course": 0, "finished": 0, "overdue": 0 } } ], "per_ticket_type": [ { "ticket_type_id": 226, "name": "Regulier", "expected": 2, "checked_in": 1 } ], "per_time_slot": [], "per_wave": [] }, "generated_at": "2026-09-29T05:53:52+00:00" } }

GET /webhooks

{ "data": { "id": "01M3NVM1FW1JE5CRSEBS114W8B", "url": "https://crm.example.test/wandelweb", "description": "CRM", "events": [ "order.paid" ], "is_active": true, "disabled_reason": null, "last_delivered_at": null, "last_failed_at": null, "created_at": "2026-09-29T05:53:52+00:00" } }

Publieke API

Bouw je een eigen website of app? De publieke API geeft de gegevens van je evenementen als JSON: titel, datum, locatie, afstanden, tickettypes met prijs en beschikbaarheid. Je hebt geen sleutel nodig en de API bevat nooit persoonsgegevens.

Alleen gepubliceerde, uitverkochte, geannuleerde en afgelopen evenementen met ticketverkoop via WandelWeb zijn zichtbaar. Verborgen evenementen en concepten staan er niet in.

Antwoorden worden 60 seconden gecachet en hebben een ETag. Stuur die mee in If-None-Match, dan krijg je 304 als er niets veranderd is. CORS staat open voor elke website (zonder cookies), zodat je de API direct vanuit de browser kunt aanroepen.

Per IP-adres zijn 120 verzoeken per minuut toegestaan; daarboven krijg je 429 met Retry-After. Cache de antwoorden zelf als je veel bezoekers hebt.

Versiebeleid: dit is versie 1, te herkennen aan de header X-WandelWeb-Api-Version: 1. We voegen alleen velden toe. Velden verdwijnen of veranderen nooit binnen versie 1; daarvoor komt er een nieuwe versie op een apart adres. Negeer onbekende velden in je code.

Endpoints

GET /api/public/events/{slug}
Eén evenement met afstanden, tickettypes, beschikbaarheid, labels en links naar de eventpagina en de checkout. Werkt ook met de public_id van het evenement.
GET /api/public/organisers/{slug}
Het profiel van een organisatie: naam, logo, korte omschrijving, website en het aantal komende en afgelopen evenementen.
GET /api/public/organisers/{slug}/events
De evenementen van een organisatie, per pagina. Komende evenementen staan op volgorde van startdatum, afgelopen evenementen nieuwste eerst.
GET /api/public/oembed
oEmbed 1.0 voor een event-URL; zie de sectie oEmbed hieronder.

Query-parameters

locale
nl of en. Vertaalt titels, labels en links. Zonder locale krijg je de taal waarin de organisator het evenement schreef.
status
Alleen bij /events: upcoming (standaard), past of all.
per_page
Alleen bij /events: 1 tot 50, standaard 20. Een hogere waarde wordt 50.
page
Alleen bij /events: paginanummer, standaard 1. meta geeft total, per_page, current_page en last_page.
url
Alleen bij /oembed, verplicht: de volledige URL van de eventpagina op WandelWeb.
format
Alleen bij /oembed: json (standaard) of xml.
maxwidth, maxheight
Alleen bij /oembed: 200 tot 2000 pixels. Onder 560 pixels hoogte krijg je de kaart zonder ticketoverzicht.

Foutcodes

304
Niet gewijzigd sinds je ETag.
404
Onbekend, niet publiek of geen ticketverkoop via WandelWeb. Bij de organisatie-endpoints en oEmbed is het antwoord {"error":"not_found"}.
422
Ongeldige parameter, bijvoorbeeld een URL buiten WandelWeb bij oEmbed.
429
Te veel verzoeken; wacht het aantal seconden uit Retry-After.

Voorbeeldantwoorden

GET /api/public/events/{slug}

{ "slug": "duinentocht", "public_id": "01JEXAMPLEEVENT00000000000", "url": "https://wandelweb.nl/nl/evenementen/duinentocht", "title": "Duinentocht", "description_html": "<p>Een tocht door de duinen van Castricum.</p>\n", "description_plain": "Een tocht door de duinen van Castricum.", "description_excerpt": "Een tocht door de duinen van Castricum.", "status": "published", "starts_at": "2027-05-15T09:00:00+02:00", "ends_at": "2027-05-15T17:00:00+02:00", "timezone": "Europe/Amsterdam", "location": { "name": "Castricum", "latitude": 52.55, "longitude": 4.63 }, "image_url": null, "logo_url": null, "accent_color": "#f65053", "organiser": { "name": "Voorbeeld Wandelvereniging", "slug": "voorbeeld-wandelvereniging", "url": "https://wandelweb.nl/nl/organisatoren/voorbeeld-wandelvereniging", "logo_url": null }, "distances": [ { "id": 1, "name": "25 km", "distance_km": 25, "starts_at": null, "availability": { "status": "available", "label": "Beschikbaar", "exact_count": null }, "time_slot_mode": "none", "time_slots": [] } ], "ticket_types": [ { "id": 1, "name": "Regulier", "description_html": "", "description": null, "price_cents": 1250, "base_price_cents": 1250, "currency": "EUR", "price_formatted": "€ 12,50", "fee_cents_for_buyer": 0, "price_tier": null, "next_price_cents": null, "vat_rate": 9, "availability": { "status": "available", "label": "Beschikbaar", "exact_count": null }, "sales_start_at": null, "sales_end_at": null, "distance_id": 1, "min_per_order": null, "max_per_order": null, "waitlist": { "enabled": false, "open": false } } ], "availability": { "status": "available", "tickets_left": null, "lowest_price_cents": 1250, "sales_open_at": null }, "discount_rules": [], "teams_enabled": false, "transfer_policy": null, "series": null, "previous_editions": [], "next_edition": null, "checkout_url": "https://wandelweb.nl/nl/evenementen/duinentocht/tickets", "embed_url": "https://wandelweb.nl/embed/events/duinentocht?lang=nl", "labels": { "order_tickets": "Tickets bestellen", "sold_out": "Uitverkocht", "not_yet_on_sale": "Nog niet in verkoop", "sales_ended": "Verkoop gesloten", "few_left": "Bijna uitverkocht", "via_wandelweb": "Tickets via WandelWeb", "available": "Tickets verkrijgbaar", "tickets_left": "Nog :count tickets", "sales_start": "Verkoop start :date", "sales_closed": "Verkoop gesloten", "from_price": "Vanaf :price", "free": "Gratis", "buy": "Tickets kopen", "choose": "Kies", "view_event": "Bekijk evenement", "organised_by": "Georganiseerd door :name", "powered_by": "Georganiseerd via WandelWeb", "tickets_caption": "Tickets voor :event", "price_tier_until": ":name tot :date", "time_slots_available": "Starttijden met plek: :count", "cancelled": "Geannuleerd" }, "powered_by_url": "https://wandelweb.nl/nl/organisatoren/features/website-embed?utm_source=embed&utm_medium=widget&utm_campaign=duinentocht", "generated_at": "2026-09-27T10:00:00+00:00" }

GET /api/public/organisers/{slug}

{ "slug": "voorbeeld-wandelvereniging", "name": "Voorbeeld Wandelvereniging", "logo_url": null, "description_excerpt": null, "website": "https://www.voorbeeld-wandelvereniging.example", "urls": { "profile": "https://wandelweb.nl/nl/organisatoren/voorbeeld-wandelvereniging" }, "events_count": { "upcoming": 1, "past": 0 } }

GET /api/public/organisers/{slug}/events

{ "data": [ { "slug": "duinentocht", "public_id": "01JEXAMPLEEVENT00000000000", "title": "Duinentocht", "status": "published", "starts_at": "2027-05-15T09:00:00+02:00", "ends_at": "2027-05-15T17:00:00+02:00", "timezone": "Europe/Amsterdam", "location": { "name": "Castricum" }, "image_url": null, "lowest_price_cents": 1250, "labels": { "order_tickets": "Tickets bestellen", "sold_out": "Uitverkocht", "not_yet_on_sale": "Nog niet in verkoop", "sales_ended": "Verkoop gesloten", "few_left": "Bijna uitverkocht", "via_wandelweb": "Tickets via WandelWeb", "available": "Tickets verkrijgbaar", "tickets_left": "Nog :count tickets", "sales_start": "Verkoop start :date", "sales_closed": "Verkoop gesloten", "from_price": "Vanaf :price", "free": "Gratis", "buy": "Tickets kopen", "choose": "Kies", "view_event": "Bekijk evenement", "organised_by": "Georganiseerd door :name", "powered_by": "Georganiseerd via WandelWeb", "tickets_caption": "Tickets voor :event", "price_tier_until": ":name tot :date", "time_slots_available": "Starttijden met plek: :count", "cancelled": "Geannuleerd" }, "urls": { "page": "https://wandelweb.nl/nl/evenementen/duinentocht" }, "series": null } ], "meta": { "total": 1, "per_page": 20, "current_page": 1, "last_page": 1 } }

GET /api/public/oembed

{ "version": "1.0", "type": "rich", "provider_name": "WandelWeb", "provider_url": "https://wandelweb.nl/", "title": "Duinentocht", "author_name": "Voorbeeld Wandelvereniging", "author_url": "https://wandelweb.nl/nl/organisatoren/voorbeeld-wandelvereniging", "html": "<iframe src=\"https://wandelweb.nl/embed/events/duinentocht/card?locale=nl&amp;variant=tickets\" width=\"100%\" height=\"560\" style=\"border:0;max-width:600px\" loading=\"lazy\" title=\"Duinentocht\"></iframe>", "width": 600, "height": 560, "cache_age": 3600 }

oEmbed

Plak de link naar je evenement in een website-bouwer die oEmbed ondersteunt, en er verschijnt vanzelf een kaart met datum, locatie, prijs en een knop naar de tickets. De knop opent de checkout van WandelWeb in hetzelfde venster, zodat betalen altijd veilig op WandelWeb gebeurt.

Ghost, Notion en andere platforms vinden de kaart via de discovery-tags op de eventpagina. WordPress toont de kaart alleen als WandelWeb op de oEmbed-lijst van WordPress staat. Werkt dat bij jou niet, gebruik dan de embed-code uit het organisatorbeheer.

Alleen publieke evenementen met ticketverkoop krijgen een kaart. Verborgen evenementen niet, zodat ze niet via een geplakte link rondgaan.

Discovery-tags op de eventpagina

<link rel="alternate" type="application/json+oembed" href="https://wandelweb.nl/api/public/oembed?url=https%3A%2F%2Fwandelweb.nl%2Fnl%2Fevenementen%2Fvoorbeeld-wandeltocht&format=json" title="Voorbeeld Wandeltocht"> <link rel="alternate" type="text/xml+oembed" href="https://wandelweb.nl/api/public/oembed?url=https%3A%2F%2Fwandelweb.nl%2Fnl%2Fevenementen%2Fvoorbeeld-wandeltocht&format=xml" title="Voorbeeld Wandeltocht">

Hoogte aanpassen

De kaart stuurt na het laden en bij elke formaatwijziging een bericht naar de pagina eromheen. Luister ernaar als je de hoogte van het iframe wilt aanpassen; zonder luisteraar houdt het iframe de vaste hoogte uit de oEmbed-response.

window.addEventListener('message', (event) => { if (event.data?.type !== 'wandelweb:resize') { return; } const frame = [...document.querySelectorAll('iframe')] .find((iframe) => iframe.contentWindow === event.source); if (frame) { frame.style.height = `${event.data.height}px`; } });

Embed-code

Wil je meer dan een kaart, zoals een ticketknop, een badge of de volledige checkout op je eigen site? Maak de embed-code in het organisatorbeheer bij je evenement onder Website-embed. Daar zie je direct een voorbeeld.

Meet je verkopen met Google Analytics of Meta? Lees hoe de embed samenwerkt met je eigen tracking.

Over de website-embed Tracking bij de embed