Entwickler

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.

180
API-Operationen
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"
Schnellstart

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
Zur API-Referenz
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 }
}
Authentifizierung

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
1. Autorisieren
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 eintauschen
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
  • Feine 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.

Webhooks

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
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);
  });
}

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
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 öffnen
  • OpenAPI-3.1-Spezifikation

    Importiere sie in Postman oder Insomnia, oder erzeuge einen Client in deiner Programmiersprache.

    openapi.json herunterladen
  • OAuth-Metadaten

    Endpunkte, Grant-Typen und unterstützte Scopes als Discovery-Dokument nach RFC 8414.

    Metadaten ansehen
MemberArea

Starte jetzt auf MemberArea

Lege deinen API-Schlüssel schon in der 14-tägigen kostenlosen Testphase an.

Keine Kreditkarte erforderlich. Jederzeit kündbar.