Pular para o conteúdo principal

Métodos de Autenticação

A Feed API suporta dois métodos: chaves de API (para integrações servidor a servidor) e Bearer tokens M2M (para fluxos OAuth).

Chave de API (Recomendado)

Passe sua chave de API no header X-API-Key:
curl https://app.alana.shopping/api/v1/feeds/google \
  -H "X-API-Key: sk_live_sua_chave_api"

Bearer Token M2M

Para integrações OAuth server-based, use um Bearer token no header Authorization:
curl https://app.alana.shopping/api/v1/feeds/google \
  -H "Authorization: Bearer seu_token_m2m"

Escopos Necessários

OperaçãoEscopo Necessário
Leitura de feedsfeed:read
Gerenciar webhooksfeed:write
Ver analyticsfeed:read
Chaves de API criadas no painel do Alana têm feed:read por padrão. Para criar assinaturas de webhook, habilite feed:write nas configurações da chave.

Criando Chaves de API

  1. Acesse Configurações → Chaves de API no seu workspace
  2. Clique em Nova Chave de API
  3. Selecione os escopos feed:read e/ou feed:write
  4. Copie a chave — ela é exibida apenas uma vez

Respostas de Erro

StatusSignificado
401 UnauthorizedChave de API ausente ou inválida
403 ForbiddenChave válida, mas escopo insuficiente
429 Too Many RequestsLimite de taxa excedido (60 req/min)
Last modified on March 18, 2026