Dla deweloperów

Buduj na MemberArea z prawdziwym REST API

Członkowie, kursy, zamówienia i płatności za jednym wersjonowanym API. Uwierzytelnij się kluczem API lub OAuth 2.0, reaguj na podpisane webhooki i zacznij od specyfikacji OpenAPI.

180
Operacji API
38
Zdarzeń webhook
34
Scope'ów OAuth
curl
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
  -H "X-Api-Key: mak_your_key"
Szybki start

Twoje pierwsze zapytanie w dwie minuty

Utwórz klucz API w panelu w Ustawienia, API. Wyślij go w nagłówku X-Api-Key albo jako bearer token, a każda odpowiedź wróci jako JSON z rekordami w data i stronicowaniem w meta.

  • Bazowy URL https://api.memberarea.io/v1
  • Klucze zaczynają się od mak_ i są pokazywane tylko raz
  • 25 rekordów na stronę, do 100 z per_page
  • Członków identyfikuje UUID, nigdy wewnętrzne id
Zobacz dokumentację API
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 }
}
Uwierzytelnianie

Klucze API do własnych skryptów, OAuth dla aplikacji

Klucz API należy do jednego konta i pasuje do zadań serwer-serwer. Aplikacja, z którą łączą się inne konta MemberArea, korzysta z OAuth 2.0 z przepływem authorization code i PKCE, więc każde konto zatwierdza dokładnie te scope'y, które przyznaje.

  • Rejestruj aplikacje w Ustawienia, Aplikacje OAuth
  • PKCE z S256, klienci publiczni i poufni
  • Access tokeny działają godzinę, refresh tokeny 60 dni
  • Discovery pod /.well-known/oauth-authorization-server
1. Autoryzuj
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. Wymień kod
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
  • Szczegółowe scope'y

    Odczyt i zapis to osobne scope'y dla każdego zasobu, na przykład members:read, members:write, courses:read albo payments:read.

  • Wymieniaj i unieważniaj

    Unieważnij klucz lub token w dowolnej chwili. Pozostałe integracje działają dalej.

  • Zależne od planu i audytowane

    Dostęp do API zależy od planu konta, a przy każdym kluczu widzisz, kiedy był ostatnio użyty.

Webhooki

Podpisane zdarzenia, zweryfikowane w dziesięciu linijkach

Webhooki działają zgodnie ze specyfikacją Standard Webhooks. Każde dostarczenie niesie webhook-id, webhook-timestamp i webhook-signature, czyli HMAC-SHA256 z id, znacznika czasu i surowej treści, z Twoim sekretem whsec_ jako kluczem.

  • Odrzucaj dostarczenia starsze niż pięć minut
  • Nieudane dostarczenia są automatycznie ponawiane
  • Każda próba trafia do dziennika dostarczeń
  • Subskrybuj i wypisuj się przez API z 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);
  });
}

Limity i błędy

Przewidywalne limity, czytelne błędy

Każdy limit jest podany w nagłówkach odpowiedzi, a każdy błąd ma ten sam kształt, więc klient obsługuje je raz.

  • Limity zapytań

    600 odczytów, 120 zapisów i 30 wyzwoleń automatyzacji na minutę, do tego limit dzienny. Powyżej API odpowiada 429 z Retry-After.

  • Stronicowanie

    page i per_page na wejściu; page, per_page, total i last_page na wyjściu w meta.

  • Jeden format błędu

    error.code dla Twojego kodu, error.message dla ludzi i error.details dla błędnych pól.

  • Limity planu

    Gdy konto osiągnie limit swojego planu, API odpowiada 402 z 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"
  }
}

Materiały

Wszystko, czego potrzebujesz na start

Dokumentacja, specyfikacja do odczytu maszynowego i metadane OAuth, zawsze generowane z tego samego źródła.

  • Dokumentacja API

    Każdy endpoint z parametrami, przykładami i wymaganym scope'em, w Twoim języku.

    Otwórz dokumentację
  • Specyfikacja OpenAPI 3.1

    Zaimportuj ją do Postmana lub Insomnii albo wygeneruj klienta w swoim języku programowania.

    Pobierz openapi.json
  • Metadane OAuth

    Endpointy, typy grantów i obsługiwane scope'y jako dokument discovery zgodny z RFC 8414.

    Zobacz metadane
MemberArea

Zacznij budować na MemberArea

Utwórz klucz API w ramach 14-dniowego bezpłatnego okresu próbnego.

Bez podawania karty. Anuluj w każdej chwili.