Ontwikkelaars
Een publieke REST-API voor clubs en gecertificeerde partners: gescopete leesrechten, boekingen via de API en met HMAC ondertekende webhooks.
Authenticatie
Elke sleutel wordt gegenereerd in het clubpaneel, onder Instellingen → Ontwikkelaars, en wordt verstuurd als Bearer-header.
curl -H "Authorization: Bearer mp_…" \
https://api.meetandplay.mx/api/v1/clubs/{clubId}/bookingsDe volledige sleutel wordt maar één keer getoond. Bewaar hem op een veilige plek.
Endpoints
Elke sleutel geeft de scopes aan waarmee hij is aangemaakt; een verzoek zonder de vereiste scope wordt geweigerd.
- GET
/clubs/{clubId}/courtsDe banencatalogus van de club.
- GET
/clubs/{clubId}/availabilityBezette tijdvakken per baan, tot 14 dagen.
- GET
/clubs/{clubId}/bookingsDe boekingen van de club, nieuwste eerst.
- GET
/clubs/{clubId}/customersHet klantenoverzicht van de club — persoonsgegevens, achter een eigen scope.
- POST
/clubs/{clubId}/bookingsMaakt een boeking aan, net als de balie van de club.
- POST
/clubs/{clubId}/bookings/{bookingId}/cancelAnnuleert een boeking; betaalt terug of maakt de betaling ongeldig volgens het beleid van de club.
Webhooks
Ontvang met HMAC-SHA256 ondertekende events op je eigen URL: boeking aangemaakt, bevestigd of geannuleerd, betaling geslaagd en partij vol. Elke bezorging probeert het opnieuw met oplopende vertraging; na meerdere mislukte pogingen komt hij in de wachtrij voor mislukte bezorgingen terecht, opnieuw te bezorgen vanuit het clubpaneel.
Snelheidslimieten
Elke sleutel heeft een limiet aan verzoeken per minuut. Een 429-reactie betekent dat de limiet is bereikt; vertraag en probeer het opnieuw.
Gecertificeerde partners
Een gecertificeerde partner verbindt met één klik vanuit het clubpaneel — zonder sleutels handmatig te kopiëren en plakken.
Klaar om je club te koppelen?
Log in op het clubpaneel en genereer je eerste sleutel onder Instellingen → Ontwikkelaars.