Bienvenue ! Pouvons-nous utiliser des cookies ?

Nous utilisons des cookies pour assurer le bon fonctionnement du site et comprendre comment vous l'utilisez. Cela nous aide à l'améliorer sans cesse.

Plus d'informations

Cookievoorkeuren

Cookies fonctionnels Nécessaires

Nécessaires au bon fonctionnement du site, par exemple pour mémoriser votre connexion et vos préférences.

Cookies analytiques

Nous aident à comprendre comment les visiteurs utilisent le site afin de l'améliorer. Nous utilisons Google Analytics à cet effet.

Cookies médias

Vous permettent de voir des vidéos et d'autres médias de services externes comme YouTube.

Pour les développeurs

Webhooks et API

Connectez votre CRM, votre système de chronométrage ou votre gestion des membres. WandelWeb envoie un HTTP POST signé pour chaque événement pertinent.

Aperçu

Chaque organisation peut enregistrer une ou plusieurs URL de webhook dans Paramètres → Intégrations. Vous choisissez les événements que vous recevez. Chaque message possède un event_id unique ; utilisez-le comme clé d'idempotence.

Les payloads contiennent des données personnelles de participants. Vous êtes responsable du traitement de ce que vous stockez. Conservez les secrets en lieu sûr et ne les partagez jamais.

Webhooks

WandelWeb envoie (POST) une enveloppe JSON à votre URL HTTPS. HTTP est autorisé en développement local. Les adresses privées et de loopback sont refusées.

Vous trouverez ci-dessous un exemple de payload par événement, généré à partir des mêmes ressources que les envois réels.

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" } } }

Vérifier la signature

Chaque envoi comporte l'en-tête X-WandelWeb-Signature sous la forme v1=<hex>. Calculez un HMAC-SHA256 sur "<timestamp>.<body>" avec votre secret de webhook et comparez en temps constant. N'acceptez que les horodatages compris dans une fenêtre de cinq minutes.

Utilisez event_id (en-tête X-WandelWeb-Event-Id et champ id dans le corps) pour ignorer les doublons. Les renvois conservent le même 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(); }

Nouvelles tentatives et désactivation

Un envoi échoué (réponse non 2xx, délai dépassé, erreur DNS ou TLS) est retenté après 1 minute, 5 minutes, 30 minutes, 2 heures et 12 heures. Ensuite, l'envoi s'arrête.

Après vingt échecs consécutifs, WandelWeb désactive le webhook et envoie un e-mail au propriétaire et aux administrateurs. Vous pouvez le réactiver vous-même.

Vie privée

Les payloads de webhook comprennent des noms, adresses e-mail, numéros de téléphone, réponses aux formulaires et numéros de dossard. L'organisateur est le responsable du traitement ; le destinataire du webhook est responsable du stockage sécurisé et de la durée de conservation.

Les secrets sont stockés chiffrés et affichés une seule fois. Renouvelez immédiatement un secret s'il a fuité.

API de lecture avec clés d'API

Avec l'API de lecture, vos propres systèmes récupèrent les événements, types de billets, commandes, billets, contrôles d'accès et statistiques. L'API est en lecture seule : les modifications se font uniquement dans WandelWeb.

Un propriétaire ou un administrateur crée une clé d'API sous Paramètres → Intégrations. La clé appartient à l'organisation, pas à une personne, elle continue donc de fonctionner quand quelqu'un quitte l'équipe. Vous ne voyez la clé qu'une seule fois ; ensuite, seulement ses quatre derniers caractères. Donnez une date d'expiration à une clé et révoquez-la immédiatement si elle fuite.

Envoyez la clé sous la forme Authorization: Bearer <key>. Chaque URL commence par /api/organiser/v1/organisers/{slug} ; une clé ne fonctionne que pour sa propre organisation. Les réponses sont en JSON avec data, links et meta ; les listes sont paginées avec page et per_page (50 par défaut, 200 maximum). Les heures sont au format ISO 8601 en UTC, les montants en centimes.

Synchronisez avec updated_since (commandes et billets, la modification la plus ancienne en premier). Chaque clé peut effectuer 300 requêtes par minute ; au-delà, vous recevez une erreur 429 avec un en-tête Retry-After. Combinez l'API avec les webhooks pour des mises à jour en temps réel.

Versionnage : au sein de v1, des champs sont uniquement ajoutés ; rien n'est jamais supprimé ni renommé. Ignorez les champs inconnus. Un changement incompatible donne lieu à une nouvelle version (/v2). Chaque réponse contient l'en-tête X-WandelWeb-Api-Version.

Vie privée : les réponses contiennent des noms, adresses e-mail, numéros de téléphone, réponses aux formulaires et numéros de dossard. L'organisateur est le responsable du traitement ; conservez ces données de manière sécurisée et pas plus longtemps que nécessaire. Les réponses portent Cache-Control: no-store.

Endpoints

GET /
Informations sur l'organisation.
GET /events
Événements avec billetterie. Filtres : status[], from, to.
GET /events/{id}
Un événement avec distances, types de billets et chiffres clés.
GET /events/{id}/ticket-types
Types de billets avec prix, capacité et nombre vendu.
GET /events/{id}/orders
Commandes. Filtres : status[], updated_since, email.
GET /orders/{public_id}
Une commande avec lignes et billets.
GET /events/{id}/tickets
Billets (valides par défaut). Filtres : status[], ticket_type_id, distance_id, bib_number, search, updated_since.
GET /tickets/{public_id}
Un billet avec ses contrôles d'accès.
GET /events/{id}/check-ins
Scans, les plus récents en premier. Filtres : scan_post_id, since, result.
GET /events/{id}/stats
Compteurs de ventes et de contrôles d'accès.
GET /webhooks
Vos webhooks, sans les secrets.

Exemple

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

Codes d'erreur

401
Clé manquante, inconnue, expirée ou révoquée.
403
Clé sans accès en lecture, organisation bloquée ou API désactivée par WandelWeb.
404
Organisation inconnue ou différente, ou objet n'appartenant pas à cette organisation.
422
Valeur de filtre non valide.
429
Trop de requêtes ; attendez le nombre de secondes indiqué dans Retry-After.

Exemples de réponses. Pour les listes, data est un tableau et links et meta sont ajoutés.

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" } }

API publique

Vous créez votre propre site web ou application ? L'API publique renvoie vos événements en JSON : titre, date, lieu, distances et types de billets avec prix et disponibilité. Vous n'avez pas besoin de clé et l'API ne contient jamais de données personnelles.

Seuls les événements publiés, complets, annulés et terminés qui vendent des billets via WandelWeb sont inclus. Les événements masqués et les brouillons ne le sont pas.

Les réponses sont mises en cache pendant 60 secondes et comportent un ETag. Renvoyez-le dans If-None-Match pour obtenir un 304 si rien n'a changé. Le CORS est ouvert à tous les sites web (sans cookies), vous pouvez donc appeler l'API directement depuis le navigateur.

Chaque adresse IP peut effectuer 120 requêtes par minute ; au-delà, vous recevez une erreur 429 avec Retry-After. Mettez vous-même les réponses en cache si vous avez beaucoup de visiteurs.

Versionnage : il s'agit de la version 1, indiquée dans l'en-tête X-WandelWeb-Api-Version: 1. Nous ajoutons uniquement des champs. Les champs ne sont jamais supprimés ni modifiés au sein de la version 1 ; cela nécessite une nouvelle version à une adresse distincte. Ignorez les champs inconnus dans votre code.

Endpoints

GET /api/public/events/{slug}
Un événement avec distances, types de billets, disponibilité, étiquettes et liens vers la page d'événement et le paiement. Fonctionne aussi avec le public_id de l'événement.
GET /api/public/organisers/{slug}
Un profil d'organisation : nom, logo, courte description, site web et nombre d'événements à venir et passés.
GET /api/public/organisers/{slug}/events
Les événements d'une organisation, par page. Les événements à venir sont triés par date de début, les événements passés du plus récent au plus ancien.
GET /api/public/oembed
oEmbed 1.0 pour une URL d'événement ; voir la section oEmbed ci-dessous.

Paramètres de requête

locale
nl ou en. Traduit les titres, étiquettes et liens. Sans locale, vous obtenez la langue dans laquelle l'organisateur a rédigé l'événement.
status
Uniquement pour /events : upcoming (par défaut), past ou all.
per_page
Uniquement pour /events : de 1 à 50, 20 par défaut. Une valeur supérieure devient 50.
page
Uniquement pour /events : numéro de page, 1 par défaut. meta renvoie total, per_page, current_page et last_page.
url
Uniquement pour /oembed, obligatoire : l'URL complète de la page d'événement sur WandelWeb.
format
Uniquement pour /oembed : json (par défaut) ou xml.
maxwidth, maxheight
Uniquement pour /oembed : de 200 à 2000 pixels. En dessous de 560 pixels de hauteur, vous obtenez la carte sans l'aperçu des billets.

Codes d'erreur

304
Non modifié depuis votre ETag.
404
Inconnu, non public ou ne vendant pas de billets via WandelWeb. Pour les endpoints d'organisation et oEmbed, la réponse est {"error":"not_found"}.
422
Paramètre non valide, par exemple une URL hors de WandelWeb pour oEmbed.
429
Trop de requêtes ; attendez le nombre de secondes indiqué dans Retry-After.

Exemples de réponses

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

Collez le lien de votre événement dans un outil de création de site compatible oEmbed et une carte apparaît avec la date, le lieu, le prix et un bouton vers les billets. Le bouton ouvre le paiement WandelWeb dans la même fenêtre, le paiement se fait donc toujours en toute sécurité sur WandelWeb.

Ghost, Notion et d'autres plateformes trouvent la carte grâce aux balises de découverte de la page d'événement. WordPress n'affiche la carte que lorsque WandelWeb figure dans la liste oEmbed de WordPress. Si cela ne fonctionne pas pour vous, utilisez le code d'intégration du tableau de bord organisateur.

Seuls les événements publics qui vendent des billets obtiennent une carte. Les événements masqués n'en ont pas, ils ne sont donc pas partagés par un lien collé.

Balises de découverte sur la page d'événement

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

Ajuster la hauteur

Après le chargement et à chaque changement de taille, la carte envoie un message à la page qui l'entoure. Écoutez-le si vous voulez ajuster la hauteur de l'iframe ; sans écouteur, l'iframe conserve la hauteur fixe de la réponse oEmbed.

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`; } });

Code d'intégration

Vous voulez plus qu'une carte, comme un bouton de billetterie, un badge ou le paiement complet sur votre propre site ? Créez le code d'intégration dans le tableau de bord organisateur, sous Intégration sur votre site, pour votre événement. Vous y voyez un aperçu en direct.

Vous mesurez vos ventes avec Google Analytics ou Meta ? Découvrez comment l'intégration fonctionne avec votre propre suivi.

À propos de l'intégration sur votre site Suivi avec l'intégration