Sviluppa su MemberArea con una vera API REST
Membri, corsi, ordini e pagamenti dietro un'unica API versionata. Autenticati con una chiave API o OAuth 2.0, reagisci a webhook firmati e parti dalla specifica OpenAPI.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"La tua prima richiesta in due minuti
Crea una chiave API nell'admin in Impostazioni, API. Inviala nell'header X-Api-Key o come bearer token, e ogni risposta torna in JSON con i record in data e la paginazione in meta.
- URL di base https://api.memberarea.io/v1
- Le chiavi iniziano con mak_ e vengono mostrate una sola volta
- 25 record per pagina, fino a 100 con per_page
- I membri si identificano con l'UUID, mai con un id interno
{
"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 }
}Chiavi API per i tuoi script, OAuth per le app
Una chiave API appartiene a un account ed è adatta ai processi server-to-server. Un'app a cui si collegano altri account MemberArea usa OAuth 2.0 con il flusso authorization code e PKCE, così ogni account approva esattamente gli scope che concede.
- Registra le app in Impostazioni, App OAuth
- PKCE con S256, client pubblici e confidenziali
- Gli access token durano un'ora, i refresh token 60 giorni
- Discovery su /.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_VERIFIERScope granulari
Lettura e scrittura sono scope separati per risorsa, per esempio members:read, members:write, courses:read o payments:read.
Ruota e revoca
Revoca una chiave o un token in qualsiasi momento. Tutte le altre integrazioni continuano a funzionare.
Legato al piano e tracciato
L'accesso all'API segue il piano dell'account e ogni chiave mostra quando è stata usata l'ultima volta.
Eventi firmati, verificati in dieci righe
I webhook seguono la specifica Standard Webhooks. Ogni consegna porta webhook-id, webhook-timestamp e webhook-signature, un HMAC-SHA256 su id, timestamp e body grezzo, con il tuo segreto whsec_ come chiave.
- Rifiuta le consegne più vecchie di cinque minuti
- Le consegne non riuscite vengono ritentate automaticamente
- Ogni tentativo finisce nel registro delle consegne
- Iscriviti e disiscriviti via API con 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);
});
}Limiti ed errori
Limiti prevedibili, errori leggibili
Ogni limite è indicato negli header della risposta e ogni errore ha la stessa forma, così un client li gestisce una volta sola.
Limiti di frequenza
600 letture, 120 scritture e 30 trigger di automazione al minuto, più un limite giornaliero. Oltre, l'API risponde 429 con Retry-After.
Paginazione
page e per_page in ingresso; page, per_page, total e last_page in uscita in meta.
Un'unica forma di errore
error.code per il tuo codice, error.message per le persone ed error.details per i campi non validi.
Limiti del piano
Quando un account raggiunge un limite del suo piano, l'API risponde 402 con 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"
}
}Risorse
Tutto ciò che ti serve per iniziare
Il riferimento, la specifica leggibile dalle macchine e i metadati OAuth, sempre generati dalla stessa fonte.
Riferimento API
Ogni endpoint con parametri, esempi e lo scope necessario, nella tua lingua.
Apri il riferimentoSpecifica OpenAPI 3.1
Importala in Postman o Insomnia, oppure genera un client nel linguaggio che usi.
Scarica openapi.jsonMetadati OAuth
Endpoint, tipi di grant e scope supportati come documento di discovery secondo RFC 8414.
Vedi i metadati

Inizia a sviluppare su MemberArea
Crea la tua chiave API durante la prova gratuita di 14 giorni.
Nessuna carta di credito richiesta. Cancella in qualsiasi momento.