Ontwikkelaars

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.

180
API-operaties
38
Webhook-events
34
OAuth-scopes
curl
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
  -H "X-Api-Key: mak_your_key"
Snelstart

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
Lees de API-referentie
JSON
{
  "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 }
}
Authenticatie

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
1. Autoriseren
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=S256
2. Code inwisselen
curl -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_VERIFIER
  • Fijnmazige 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.

Webhooks

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
Node.js
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
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 openen
  • OpenAPI 3.1-specificatie

    Importeer hem in Postman of Insomnia, of genereer een client in de taal waarin je werkt.

    openapi.json downloaden
  • OAuth-metadata

    Endpoints, grant types en ondersteunde scopes als discovery-document volgens RFC 8414.

    Metadata bekijken
MemberArea

Begin met bouwen op MemberArea

Maak je API-sleutel al aan tijdens de gratis proefperiode van 14 dagen.

Geen creditcard nodig. Altijd opzegbaar.