API keys

Uma API key é a credencial server-to-server do seu tenant. Você a emite no console e a usa no backend como Authorization: Bearer lidmo_sk_….

Emitir (no console)

Emitir e revogar keys é um ato administrativo — restrito a owner/admin.

1. Console → API keys → Nova API key.
2. Dê um nome (ex.: “backend de produção”) e escolha o papel da key.
3. O token aparece uma única vez. Copie e guarde agora — ele não é exibido novamente.

O token só aparece na criação

Guardamos a key apenas como hash (de forma irreversível) — nunca o texto. Se você perder o token, revogue a key e emita outra. Não há recuperação.

Papéis de uma key

Papel	Uso
developer (padrão)	integra a API: enviar mensagens, gerenciar webhooks
viewer	somente leitura

Os papéis owner e admin não são atribuíveis a uma key: uma key integra a API, não administra o tenant nem emite outras keys.

Usar

Basta enviar a key no cabeçalho Authorization:

curl -X POST https://api-bsp.lidmo.app/v1/messages \
  -H "Authorization: Bearer lidmo_sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "channel": "whatsapp", "to": "5511999999999", "type": "text", "text": { "body": "Olá!" } }'

A key identifica o seu tenant e o papel; o broker resolve o ativo de envio.

Listar e revogar

A gestão das keys (listar, revogar) é feita no console, em API keys:

• Listar — a tabela mostra as keys ativas e revogadas pelo prefix (nunca o token), com papel, último uso e data.
• Revogar — a revogação é imediata e irreversível: qualquer integração usando aquela key passa a receber 401.

Rotação

Para trocar uma key sem downtime: emita a nova no console, atualize o backend para usá-la e só então revogue a antiga. As duas funcionam no intervalo de sobreposição.