Entwickle auf MemberArea mit einer echten REST-API
Mitglieder, Kurse, Bestellungen und Zahlungen hinter einer versionierten API. Authentifiziere dich per API-Schlüssel oder OAuth 2.0, reagiere auf signierte Webhooks und starte mit der OpenAPI-Spezifikation.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"Deine erste Anfrage in zwei Minuten
Lege im Admin unter Einstellungen, API einen API-Schlüssel an. Schick ihn im Header X-Api-Key oder als Bearer-Token mit, und jede Antwort kommt als JSON zurück, mit den Datensätzen in data und der Seitennavigation in meta.
- Basis-URL https://api.memberarea.io/v1
- Schlüssel beginnen mit mak_ und werden einmal angezeigt
- 25 Datensätze pro Seite, bis zu 100 mit per_page
- Mitglieder werden per UUID angesprochen, nie über eine 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-Schlüssel für eigene Skripte, OAuth für Apps
Ein API-Schlüssel gehört zu einem Konto und passt für Server-zu-Server-Jobs. Eine App, die andere MemberArea-Konten verbinden, nutzt OAuth 2.0 mit Authorization Code Flow und PKCE, damit jedes Konto genau die Scopes freigibt, die es gewährt.
- Apps unter Einstellungen, OAuth-Apps registrieren
- PKCE mit S256, öffentliche und vertrauliche Clients
- Access-Tokens gelten eine Stunde, Refresh-Tokens 60 Tage
- Discovery unter /.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_VERIFIERFeine Scopes
Lesen und Schreiben sind getrennte Scopes je Ressource, zum Beispiel members:read, members:write, courses:read oder payments:read.
Rotieren und widerrufen
Widerrufe einen Schlüssel oder ein Token jederzeit. Alle anderen Integrationen laufen weiter.
Tarifgebunden und nachvollziehbar
Der API-Zugang richtet sich nach dem Tarif des Kontos, und jeder Schlüssel zeigt, wann er zuletzt genutzt wurde.
Signierte Events, in zehn Zeilen geprüft
Webhooks folgen der Spezifikation Standard Webhooks. Jede Zustellung trägt webhook-id, webhook-timestamp und webhook-signature, ein HMAC-SHA256 über ID, Zeitstempel und Rohdaten, geschlüsselt mit deinem whsec_-Secret.
- Zustellungen älter als fünf Minuten ablehnen
- Fehlgeschlagene Zustellungen werden automatisch wiederholt
- Jeder Versuch landet im Zustellprotokoll
- Per API mit webhooks:manage abonnieren und abbestellen
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);
});
}Limits und Fehler
Planbare Limits, lesbare Fehler
Jedes Limit steht in den Antwort-Headern, und jeder Fehler hat dieselbe Form, sodass ein Client sie einmal behandelt.
Rate Limits
600 Lese-, 120 Schreibzugriffe und 30 Automations-Auslöser pro Minute, dazu ein Tageslimit. Darüber antwortet die API mit 429 und Retry-After.
Paginierung
page und per_page rein, page, per_page, total und last_page raus in meta.
Eine Fehlerform
error.code für deinen Code, error.message für Menschen und error.details für die fehlerhaften Felder.
Plan-Limits
Erreicht ein Konto ein Limit seines Tarifs, antwortet die API mit 402 und 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"
}
}Ressourcen
Alles, was du zum Loslegen brauchst
Die Referenz, die maschinenlesbare Spezifikation und die OAuth-Metadaten, immer aus derselben Quelle erzeugt.
API-Referenz
Jeder Endpunkt mit Parametern, Beispielen und dem nötigen Scope, in deiner Sprache.
Referenz öffnenOpenAPI-3.1-Spezifikation
Importiere sie in Postman oder Insomnia, oder erzeuge einen Client in deiner Programmiersprache.
openapi.json herunterladenOAuth-Metadaten
Endpunkte, Grant-Typen und unterstützte Scopes als Discovery-Dokument nach RFC 8414.
Metadaten ansehen

Starte jetzt auf MemberArea
Lege deinen API-Schlüssel schon in der 14-tägigen kostenlosen Testphase an.
Keine Kreditkarte erforderlich. Jederzeit kündbar.