Développeurs

Développez sur MemberArea avec une vraie API REST

Membres, cours, commandes et paiements derrière une API versionnée. Authentifiez-vous par clé API ou OAuth 2.0, réagissez à des webhooks signés et partez de la spécification OpenAPI.

180
Opérations API
38
Événements webhook
34
Scopes OAuth
curl
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
  -H "X-Api-Key: mak_your_key"
Démarrage rapide

Votre première requête en deux minutes

Créez une clé API dans l'admin, sous Paramètres, API. Envoyez-la dans l'en-tête X-Api-Key ou comme bearer token, et chaque réponse revient en JSON avec les enregistrements dans data et la pagination dans meta.

  • URL de base https://api.memberarea.io/v1
  • Les clés commencent par mak_ et ne s'affichent qu'une fois
  • 25 enregistrements par page, jusqu'à 100 avec per_page
  • Les membres sont identifiés par UUID, jamais par un id interne
Lire la référence de l'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 }
}
Authentification

Des clés API pour vos scripts, OAuth pour les applications

Une clé API appartient à un compte et convient aux tâches de serveur à serveur. Une application à laquelle d'autres comptes MemberArea se connectent utilise OAuth 2.0 avec le flux authorization code et PKCE, afin que chaque compte approuve exactement les scopes qu'il accorde.

  • Enregistrez vos applications sous Paramètres, Applications OAuth
  • PKCE avec S256, clients publics et confidentiels
  • Les access tokens durent une heure, les refresh tokens 60 jours
  • Discovery sur /.well-known/oauth-authorization-server
1. Autoriser
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. Échanger le code
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
  • Scopes granulaires

    Lecture et écriture sont des scopes distincts par ressource, par exemple members:read, members:write, courses:read ou payments:read.

  • Renouveler et révoquer

    Révoquez une clé ou un token à tout moment. Les autres intégrations continuent de fonctionner.

  • Lié à l'offre et traçable

    L'accès à l'API suit l'offre du compte, et chaque clé indique quand elle a été utilisée pour la dernière fois.

Webhooks

Des événements signés, vérifiés en dix lignes

Les webhooks suivent la spécification Standard Webhooks. Chaque livraison porte webhook-id, webhook-timestamp et webhook-signature, un HMAC-SHA256 sur l'id, l'horodatage et le corps brut, avec votre secret whsec_ comme clé.

  • Rejetez les livraisons de plus de cinq minutes
  • Les livraisons échouées sont relancées automatiquement
  • Chaque tentative figure dans le journal des livraisons
  • Abonnez-vous et désabonnez-vous via l'API avec 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);
  });
}

Limites et erreurs

Des limites prévisibles, des erreurs lisibles

Chaque limite est annoncée dans les en-têtes de réponse, et chaque erreur a la même forme : un client les gère une seule fois.

  • Limites de débit

    600 lectures, 120 écritures et 30 déclenchements d'automatisation par minute, plus un plafond quotidien. Au-delà, l'API répond 429 avec Retry-After.

  • Pagination

    page et per_page en entrée ; page, per_page, total et last_page en sortie dans meta.

  • Une seule forme d'erreur

    error.code pour votre code, error.message pour les humains et error.details pour les champs en erreur.

  • Limites du plan

    Quand un compte atteint une limite de son offre, l'API répond 402 avec 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"
  }
}

Ressources

Tout ce qu'il vous faut pour commencer

La référence, la spécification lisible par machine et les métadonnées OAuth, toujours générées depuis la même source.

  • Référence de l'API

    Chaque endpoint avec ses paramètres, des exemples et le scope requis, dans votre langue.

    Ouvrir la référence
  • Spécification OpenAPI 3.1

    Importez-la dans Postman ou Insomnia, ou générez un client dans votre langage.

    Télécharger openapi.json
  • Métadonnées OAuth

    Endpoints, types de grant et scopes pris en charge, en document de discovery selon la RFC 8414.

    Voir les métadonnées
MemberArea

Commencez à développer sur MemberArea

Créez votre clé API pendant l'essai gratuit de 14 jours.

Aucune carte de crédit requise. Annulez à tout moment.