Desarrolladores

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.

180
Operaciones de la API
38
Eventos de webhook
34
Scopes OAuth
curl
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
  -H "X-Api-Key: mak_your_key"
Inicio rápido

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
Ver la referencia de la 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 }
}
Autenticación

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
1. Autorizar
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. Canjear el código
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 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.

Webhooks

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

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
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 referencia
  • Especificación OpenAPI 3.1

    Impórtela en Postman o Insomnia, o genere un cliente en el lenguaje con el que trabaja.

    Descargar openapi.json
  • Metadatos OAuth

    Endpoints, tipos de grant y scopes admitidos como documento de discovery según RFC 8414.

    Ver los metadatos
MemberArea

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.