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&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.