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.
curl "https://api.memberarea.io/v1/members?per_page=5&include=tags" \
-H "X-Api-Key: mak_your_key"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
{
"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 }
}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
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
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.
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
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/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ênciaEspecificação OpenAPI 3.1
Importe-a no Postman ou no Insomnia, ou gere um cliente na linguagem em que você trabalha.
Baixar openapi.jsonMetadados OAuth
Endpoints, tipos de grant e scopes suportados como documento de discovery conforme a RFC 8414.
Ver os metadados

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.