Bouw op MemberArea met een echte REST-API
Leden, cursussen, bestellingen en betalingen achter één geversioneerde API. Authenticeer met een API-sleutel of OAuth 2.0, reageer op ondertekende webhooks en begin met de OpenAPI-specificatie.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"Je eerste request in twee minuten
Maak in de admin onder Instellingen, API een API-sleutel aan. Stuur die mee in de header X-Api-Key of als bearer token, en elk antwoord komt terug als JSON met de records in data en de paginering in meta.
- Basis-URL https://api.memberarea.io/v1
- Sleutels beginnen met mak_ en worden één keer getoond
- 25 records per pagina, tot 100 met per_page
- Leden worden aangesproken via UUID, nooit via een interne id
{
"data": [
{
"id": "9b1f6c2e-4d0a-4c55-9a3e-2f7d1c8b6a10",
"first_name": "Lena",
"last_name": "Weber",
"email": "lena@example.com",
"status": 1,
"created_at": "2026-10-02T09:14:00+00:00",
"tags": [
{
"id": "4f2a9c71-0b3e-4d8a-a6c5-7e1d2b9f8a34",
"name": "VIP",
"color": "#f59e0b",
"assigned_at": "2026-10-02T09:15:00+00:00"
}
]
}
],
"meta": { "page": 1, "per_page": 5, "total": 128, "last_page": 26 }
}API-sleutels voor je eigen scripts, OAuth voor apps
Een API-sleutel hoort bij één account en past bij server-naar-serverjobs. Een app waarmee andere MemberArea-accounts verbinden, gebruikt OAuth 2.0 met de authorization code flow en PKCE, zodat elk account precies de scopes goedkeurt die het toekent.
- Registreer apps onder Instellingen, OAuth-apps
- PKCE met S256, publieke en vertrouwelijke clients
- Access tokens gelden een uur, refresh tokens 60 dagen
- Discovery op /.well-known/oauth-authorization-server
https://app.memberarea.io/oauth/authorize
?response_type=code
&client_id=mac_your_client
&redirect_uri=https://yourapp.com/callback
&scope=members:read courses:read
&state=random_state
&code_challenge=BASE64URL_SHA256_OF_VERIFIER
&code_challenge_method=S256curl -X POST https://app.memberarea.io/oauth/token \
-d grant_type=authorization_code \
-d code=CODE_FROM_CALLBACK \
-d redirect_uri=https://yourapp.com/callback \
-d client_id=mac_your_client \
-d client_secret=mas_your_secret \
-d code_verifier=YOUR_VERIFIERFijnmazige scopes
Lezen en schrijven zijn aparte scopes per resource, bijvoorbeeld members:read, members:write, courses:read of payments:read.
Roteren en intrekken
Trek een sleutel of token op elk moment in. Alle andere integraties blijven draaien.
Gekoppeld aan het abonnement en controleerbaar
API-toegang volgt het abonnement van het account, en bij elke sleutel zie je wanneer die het laatst is gebruikt.
Ondertekende events, gecontroleerd in tien regels
Webhooks volgen de specificatie Standard Webhooks. Elke levering bevat webhook-id, webhook-timestamp en webhook-signature, een HMAC-SHA256 over id, tijdstempel en ruwe body, met je whsec_-secret als sleutel.
- Weiger leveringen die ouder zijn dan vijf minuten
- Mislukte leveringen worden automatisch opnieuw geprobeerd
- Elke poging komt in het leveringslog
- Aan- en afmelden via de API met webhooks:manage
import crypto from "node:crypto";
export function verify(req, rawBody, secret) {
const { "webhook-id": id, "webhook-timestamp": ts, "webhook-signature": sig = "" } = req.headers;
if (!id || !ts || Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const key = Buffer.from(secret.slice(6), "base64");
const mac = crypto.createHmac("sha256", key).update(`${id}.${ts}.${rawBody}`).digest("base64");
const expected = Buffer.from(`v1,${mac}`);
return sig.split(" ").some((s) => {
const given = Buffer.from(s);
return given.length === expected.length && crypto.timingSafeEqual(given, expected);
});
}Limieten en fouten
Voorspelbare limieten, leesbare fouten
Elke limiet staat in de response-headers en elke fout heeft dezelfde vorm, zodat een client ze één keer afhandelt.
Rate limits
600 leesacties, 120 schrijfacties en 30 automatiseringstriggers per minuut, plus een daglimiet. Daarboven antwoordt de API met 429 en Retry-After.
Paginering
page en per_page erin, page, per_page, total en last_page eruit in meta.
Eén foutvorm
error.code voor je code, error.message voor mensen en error.details voor de velden die fout gingen.
Pakketlimieten
Bereikt een account een limiet van zijn abonnement, dan antwoordt de API met 402 en plan_limit_reached.
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Retry in 12s.",
"window": "minute"
}
}Bronnen
Alles wat je nodig hebt om te beginnen
De referentie, de machineleesbare specificatie en de OAuth-metadata, altijd uit dezelfde bron gegenereerd.
API-referentie
Elk endpoint met parameters, voorbeelden en de benodigde scope, in je eigen taal.
Referentie openenOpenAPI 3.1-specificatie
Importeer hem in Postman of Insomnia, of genereer een client in de taal waarin je werkt.
openapi.json downloadenOAuth-metadata
Endpoints, grant types en ondersteunde scopes als discovery-document volgens RFC 8414.
Metadata bekijken

Begin met bouwen op MemberArea
Maak je API-sleutel al aan tijdens de gratis proefperiode van 14 dagen.
Geen creditcard nodig. Altijd opzegbaar.