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.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"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
{
"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 }
}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
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_VERIFIERSzczegół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.
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
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/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.jsonMetadane OAuth
Endpointy, typy grantów i obsługiwane scope'y jako dokument discovery zgodny z RFC 8414.
Zobacz metadane

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.