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.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"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
{
"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 }
}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
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_VERIFIERScopes 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.
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
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/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érenceSpécification OpenAPI 3.1
Importez-la dans Postman ou Insomnia, ou générez un client dans votre langage.
Télécharger openapi.jsonMé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

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.