API Docs · Enterprise

API do Afilira

Conecte o Afilira aos seus sistemas: consulte ofertas, dispare broadcasts e receba eventos por webhook. A API REST está disponível no plano Enterprise.

Autenticação

Chaves Bearer

Gere sua chave de API no painel (Configurações → API) e envie no cabeçalho Authorization de cada requisição. Todas as chamadas usam HTTPS e a base https://api.afilira.com.

Exemplo de requisição

curl https://api.afilira.com/v1/ofertas \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json"

Ofertas

GET/v1/ofertas

Lista as ofertas capturadas na sua operação, com filtro por plataforma e data.

POST/v1/ofertas

Envia uma oferta manual para a fila de publicação dos seus grupos de destino.

GET/v1/ofertas/:id

Detalhes de uma oferta: origem, link convertido, status e destinos.

Broadcast

POST/v1/broadcast

Dispara ou agenda um broadcast em massa para os grupos selecionados.

GET/v1/broadcast/:id

Status de um disparo: enviados, pendentes e falhas por grupo.

DELETE/v1/broadcast/:id

Cancela um broadcast agendado antes do envio.

Webhooks

POST/v1/webhooks

Registra uma URL para receber eventos (oferta publicada, sessão desconectada, pagamento confirmado).

GET/v1/webhooks

Lista os webhooks ativos da sua conta.

DELETE/v1/webhooks/:id

Remove um webhook registrado.

Limites

Rate limiting

O limite padrão é de 120 requisições por minuto por chave. Ao exceder, a API responde 429 Too Many Requests com o cabeçalho Retry-After indicando quando tentar de novo.

Resposta de erro padrão

{
  "error": {
    "code": "rate_limited",
    "message": "Limite de 120 req/min excedido. Tente novamente em 12s."
  }
}

Precisa da API na sua operação?

A API REST e os webhooks estão disponíveis no plano Enterprise. Sem fidelidade — cancele quando quiser.

Criar conta

Sem fidelidade · Cancele quando quiser