Autenticação

Todas as requisições à API requerem autenticação via API key.

Usando sua API Key

Envie a key no header x-api-key em toda requisição:

curl https://endpoint.wi.api.br/sessions \
  -H "x-api-key: wak_SuaChaveAqui..."

Cada API key tem um role que define o que ela pode fazer:

Role	Permissão
`admin`	Acesso total: criar/deletar sessões, gerenciar keys e webhooks
`operator`	Enviar/receber mensagens, gerenciar webhooks
`viewer`	Apenas leitura: status da sessão, histórico de mensagens

Você pode configurar cada key com:

Crie e gerencie suas keys pelo dashboard em Configurações → API Keys.

A API aplica rate limiting por key. Se exceder o limite, receberá:

HTTP/1.1 429 Too Many Requests

Aguarde alguns segundos e tente novamente.

Status	Significado
`401 Unauthorized`	Key ausente, inválida ou expirada
`403 Forbidden`	Key válida mas sem permissão para o recurso
`429 Too Many Requests`	Rate limit excedido