Desarrolle sobre MemberArea con una API REST de verdad
Miembros, cursos, pedidos y pagos detrás de una API versionada. Autentíquese con una clave API u OAuth 2.0, reaccione a webhooks firmados y parta de la especificación OpenAPI.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"Su primera petición en dos minutos
Cree una clave API en el admin, en Ajustes, API. Envíela en la cabecera X-Api-Key o como bearer token, y cada respuesta llega como JSON con los registros en data y la paginación en meta.
- URL base https://api.memberarea.io/v1
- Las claves empiezan por mak_ y se muestran una sola vez
- 25 registros por página, hasta 100 con per_page
- Los miembros se identifican por UUID, nunca por 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 }
}Claves API para sus propios scripts, OAuth para apps
Una clave API pertenece a una cuenta y sirve para tareas de servidor a servidor. Una app a la que se conectan otras cuentas de MemberArea usa OAuth 2.0 con el flujo de código de autorización y PKCE, así cada cuenta aprueba exactamente los scopes que concede.
- Registre apps en Ajustes, Apps OAuth
- PKCE con S256, clientes públicos y confidenciales
- Los access tokens duran una hora y los refresh tokens 60 días
- Discovery en /.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 granulares
Lectura y escritura son scopes separados por recurso, por ejemplo members:read, members:write, courses:read o payments:read.
Rotar y revocar
Revoque una clave o un token en cualquier momento. Las demás integraciones siguen funcionando.
Según el plan y auditado
El acceso a la API depende del plan de la cuenta, y cada clave muestra cuándo se usó por última vez.
Eventos firmados, verificados en diez líneas
Los webhooks siguen la especificación Standard Webhooks. Cada entrega lleva webhook-id, webhook-timestamp y webhook-signature, un HMAC-SHA256 sobre id, timestamp y cuerpo sin procesar, con su secreto whsec_ como clave.
- Rechace entregas de hace más de cinco minutos
- Las entregas fallidas se reintentan automáticamente
- Cada intento queda en el registro de entregas
- Suscríbase y cancele por 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);
});
}Límites y errores
Límites previsibles, errores legibles
Cada límite se anuncia en las cabeceras de la respuesta y cada error tiene la misma forma, así un cliente los gestiona una sola vez.
Límites de peticiones
600 lecturas, 120 escrituras y 30 disparadores de automatización por minuto, más un límite diario. Por encima, la API responde 429 con Retry-After.
Paginación
page y per_page de entrada; page, per_page, total y last_page de salida en meta.
Un único formato de error
error.code para su código, error.message para personas y error.details para los campos que fallaron.
Límites del plan
Cuando una cuenta alcanza un límite de su plan, la API responde 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"
}
}Recursos
Todo lo que necesita para empezar a desarrollar
La referencia, la especificación legible por máquina y los metadatos OAuth, siempre generados desde la misma fuente.
Referencia de la API
Cada endpoint con parámetros, ejemplos y el scope que necesita, en su idioma.
Abrir la referenciaEspecificación OpenAPI 3.1
Impórtela en Postman o Insomnia, o genere un cliente en el lenguaje con el que trabaja.
Descargar openapi.jsonMetadatos OAuth
Endpoints, tipos de grant y scopes admitidos como documento de discovery según RFC 8414.
Ver los metadatos

Empiece a desarrollar sobre MemberArea
Cree su clave API durante la prueba gratuita de 14 días.
Sin tarjeta de crédito. Cancele cuando quiera.