Autenticação

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

  1. A chave começa com wak_.
  2. Existe no banco (lookup por hash).
  3. Não está revogada (revokedAt nulo).
  4. Não está expirada (expiresAt nulo 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.

A chave é exibida uma única vez no momento da criação (formato 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.
Pular para o conteúdo