Autenticação
Autentique na API WaBlast com uma chave Bearer wak_. Validações, erro 401 e gestão de chaves.
Toda chamada autenticada envia um header HTTP Bearer (RFC 6750):
Authorization: Bearer wak_<sua_chave>
Chaves sem o prefixo wak_ são rejeitadas imediatamente. A chave é criada no painel em /developers/keys.
Validações a cada request
- A chave começa com
wak_. - Existe no banco (lookup por hash).
- Não está revogada (
revokedAtnulo). - Não está expirada (
expiresAtnulo ou no futuro).
O backend armazena apenas o hash SHA-256(pepper + chave); a comparação é feita em tempo constante.
Toda chamada autenticada resolve o usuário dono da chave e todas as queries são escopadas a esse usuário — não há acesso cross-tenant.
wak_ + segredo base64url de 24 bytes ≈ 36 chars). Guarde-a em local seguro (vault, variável de ambiente, gerenciador de segredos).Erro de autenticação (401)
{ "error": "Chave de API ausente, inválida ou revogada", "code": "UNAUTHENTICATED" }
| HTTP | code | Quando |
|---|---|---|
| 401 | UNAUTHENTICATED | API key ausente, inválida, revogada ou expirada |
Gerenciamento de chaves
A criação, listagem, revogação e rotação são feitas pelo painel em /developers/keys.
- Criar — gera chave nova; texto puro exibido uma única vez.
- Listar — mostra metadados (sem o segredo).
- Revogar — marca
revokedAt. Não pode ser desfeita. - Rotacionar — cria nova chave e revoga a antiga em transação atômica. O
expiresAté herdado. Texto puro da nova chave exibido uma única vez.