Koppel aan het spaarprogramma
Een kassa, app, webshop of AI-agent praat via deze API met het spaarprogramma van Binck Padel: leden opzoeken, punten bijschrijven, beloningen inwisselen en extraatjes afstrepen. Alles staat meteen op de spaarkaart en de wallet-pas.
https://rjeeafstaycxqlmwpccc.supabase.co/functions/v1/apiREST + JSON
gewone HTTPS-aanroepen
OpenAPI 3.1
in te laden in elke tool
120 / minuut
per sleutel
Logboek
op elke aanroep
In drie stappen live
Vraag een sleutel
Een admin van Binck Padel maakt een sleutel voor je aan in het dashboard: alleen lezen, of ook schrijven. Je ziet hem één keer, dus bewaar hem veilig, bijvoorbeeld als BP_API_KEY.
Test je sleutel
Vraag op bij welke club je sleutel hoort en wat hij mag.
curl -s "https://rjeeafstaycxqlmwpccc.supabase.co/functions/v1/api/v1/me" \
-H "Authorization: Bearer $BP_API_KEY"Laad de spec
Importeer de OpenAPI-spec in Postman of Insomnia, genereer er een client mee, of geef hem aan een AI-agent. Alle endpoints, velden en foutcodes staan erin.
openapi.jsonWat je moet weten
Zo blijft het spaarprogramma eerlijk, ook als er software aan hangt.
Eén sleutel, één club
Stuur je sleutel mee als Authorization: Bearer bp_… Een sleutel hoort bij precies één club; een club meegeven kan niet en hoeft niet.
Lezen of schrijven
Een leessleutel vraagt op. Alleen een sleutel met de scope write mag punten muteren, inwisselen, afstrepen of leden aanmelden. Verwijderen kan via de API nooit.
Limieten
120 aanroepen per minuut per sleutel, en maximaal 1.000 punten per mutatie. Daarboven krijg je 429 of 400 terug, er gebeurt niets.
Veilig herhalen
Geef bij een mutatie een eigen idempotency_key mee, bijvoorbeeld je ordernummer. Dezelfde sleutel telt maar één keer, ook na een time-out en een retry.
Spaarkaart en wallet-pas
Wat je via de API bijschrijft, afboekt of inwisselt, staat meteen op de spaarkaart en gaat vanzelf mee naar de wallet-pas.
Alles in het logboek
Elke aanroep komt met sleutelnaam, pad en uitkomst in het logboek van de club. Een sleutel intrekken werkt direct.
Als het misgaat
Een fout is altijd JSON met een leesbare error en een vaste code waar je software op kan sturen. Bij een fout is er niets veranderd.
{
"error": "Niet genoeg punten: saldo 40, nodig 80",
"code": "insufficient_points",
"points_balance": 40,
"missing": 40
}- 400
bad_requestEen verplicht veld ontbreekt of klopt niet. - 400
too_largeMeer dan 1.000 punten in één mutatie. - 401
unauthorizedGeen, een onbekende of een ingetrokken sleutel. - 403
read_onlySchrijfactie met een leessleutel. - 404
not_foundLid, beloning of extraatje bestaat niet bij deze club. - 409
insufficient_pointsTe weinig punten om in te wisselen; het veld missing zegt hoeveel. - 409
not_valid_nowExtraatje is alleen geldig op de dag van de boeking. - 409
conflictIemand anders handelde het net af. - 429
rate_limitedMeer dan 120 aanroepen in een minuut. - 500
server_errorEr ging aan onze kant iets mis; probeer het opnieuw.
Veelgebruikte koppelingen
De paar aanroepen die je voor de meeste koppelingen nodig hebt.
Kassa: pas scannen en inwisselen
De QR op de spaarkaart bevat het lid-id. Zoek het lid op, toon het saldo en de beloningen, en wissel in.
- 1GET /v1/members/lookup?identifier=…lid + saldo
- 2GET /v1/rewardswat er te kiezen is
- 3POST /v1/members/{id}/redeeminwisselen, met idempotency_key
Webshop of horeca: punten bijschrijven
Na een betaling zoek je het lid op e-mailadres en schrijf je punten bij. Het ordernummer als idempotency_key voorkomt dubbel tellen.
- 1GET /v1/members/lookup?identifier=…lid op e-mail
- 2POST /v1/members/{id}/pointspunten + omschrijving
Bar: extraatje uitgeven
Wie in een tijdvak met een extraatje boekte, heeft op de speeldag iets tegoed. Bekijk het en streep het af; het kost het lid geen punten.
- 1GET /v1/perks?member_id=…openstaande extraatjes
- 2POST /v1/perks/{id}/claimafstrepen
Alle endpoints
Iets koppelen met Binck Padel?
Vertel wat je wilt bouwen; dan krijg je een sleutel met precies de rechten die daarvoor nodig zijn.