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..."

Caution

Nunca exponha sua API key no frontend ou em repositórios públicos. Use-a apenas em chamadas server-to-server.

Roles (permissões)

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

Restrições opcionais

Você pode configurar cada key com:

• Expiração: key expira automaticamente na data definida
• IPs permitidos: aceita requisições apenas de IPs específicos
• Sessões permitidas: limita acesso a sessões específicas

Gerenciando API Keys

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

Rate Limiting

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.

Respostas de erro de autenticação

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