Sviluppatori

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.

180
Operazioni API
38
Eventi webhook
34
Scope OAuth
curl
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
  -H "X-Api-Key: mak_your_key"
Avvio rapido

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
Leggi il riferimento 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 }
}
Autenticazione

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
1. Autorizza
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. Scambia il codice
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
  • Scope 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.

Webhook

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

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
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 riferimento
  • Specifica OpenAPI 3.1

    Importala in Postman o Insomnia, oppure genera un client nel linguaggio che usi.

    Scarica openapi.json
  • Metadati OAuth

    Endpoint, tipi di grant e scope supportati come documento di discovery secondo RFC 8414.

    Vedi i metadati
MemberArea

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.