Desenvolvedores

Desenvolva sobre o MemberArea com uma API REST de verdade

Membros, cursos, pedidos e pagamentos atrás de uma API versionada. Autentique-se com uma chave de API ou OAuth 2.0, reaja a webhooks assinados e comece pela especificação OpenAPI.

180
Operações da 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"
Início rápido

Sua primeira requisição em dois minutos

Crie uma chave de API no admin em Configurações, API. Envie-a no cabeçalho X-Api-Key ou como bearer token, e cada resposta volta como JSON com os registros em data e a paginação em meta.

  • URL base https://api.memberarea.io/v1
  • As chaves começam com mak_ e aparecem uma única vez
  • 25 registros por página, até 100 com per_page
  • Membros são identificados por UUID, nunca por um id interno
Ler a referência da 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 }
}
Autenticação

Chaves de API para seus próprios scripts, OAuth para apps

Uma chave de API pertence a uma conta e serve para tarefas de servidor para servidor. Um app ao qual outras contas MemberArea se conectam usa OAuth 2.0 com o fluxo authorization code e PKCE, para que cada conta aprove exatamente os scopes que concede.

  • Registre apps em Configurações, Apps OAuth
  • PKCE com S256, clientes públicos e confidenciais
  • Access tokens valem uma hora, refresh tokens 60 dias
  • Discovery em /.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. Trocar o 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

    Leitura e escrita são scopes separados por recurso, por exemplo members:read, members:write, courses:read ou payments:read.

  • Rotacionar e revogar

    Revogue uma chave ou um token a qualquer momento. As demais integrações continuam funcionando.

  • Vinculado ao plano e auditado

    O acesso à API segue o plano da conta, e cada chave mostra quando foi usada pela última vez.

Webhooks

Eventos assinados, verificados em dez linhas

Os webhooks seguem a especificação Standard Webhooks. Cada entrega traz webhook-id, webhook-timestamp e webhook-signature, um HMAC-SHA256 sobre id, timestamp e corpo bruto, com seu segredo whsec_ como chave.

  • Rejeite entregas com mais de cinco minutos
  • Entregas com falha são repetidas automaticamente
  • Cada tentativa fica no registro de entregas
  • Assine e cancele pela API com 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 e erros

Limites previsíveis, erros legíveis

Cada limite aparece nos cabeçalhos da resposta e cada erro tem o mesmo formato, então um cliente os trata uma única vez.

  • Limites de requisições

    600 leituras, 120 gravações e 30 disparos de automação por minuto, além de um limite diário. Acima disso, a API responde 429 com Retry-After.

  • Paginação

    page e per_page na entrada; page, per_page, total e last_page na saída em meta.

  • Um único formato de erro

    error.code para o seu código, error.message para pessoas e error.details para os campos com erro.

  • Limites do plano

    Quando uma conta atinge um limite do plano, a API responde 402 com 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

Tudo o que você precisa para começar

A referência, a especificação legível por máquina e os metadados OAuth, sempre gerados da mesma fonte.

  • Referência da API

    Cada endpoint com parâmetros, exemplos e o scope necessário, no seu idioma.

    Abrir a referência
  • Especificação OpenAPI 3.1

    Importe-a no Postman ou no Insomnia, ou gere um cliente na linguagem em que você trabalha.

    Baixar openapi.json
  • Metadados OAuth

    Endpoints, tipos de grant e scopes suportados como documento de discovery conforme a RFC 8414.

    Ver os metadados
MemberArea

Comece a desenvolver sobre o MemberArea

Crie sua chave de API durante o teste grátis de 14 dias.

Sem necessidade de cartão de crédito. Cancele quando quiser.