Acesso à API

WallaWhats expõe as mesmas operações que o painel usa através de uma API HTTP JSON. Usa-a para automatizar a gestão de subscrições, trazer o histórico de notificações para os teus próprios sistemas ou integrar alertas com ferramentas internas. Cada plano pago inclui acesso à API — vê Gere o teu plano para os limites de chaves por plano.

Passo 1 — Abre Chaves API

Na barra lateral, clica em Chaves API (em Chaves de acesso).

Passo 2 — Cria uma chave

1. Clica em Criar chave.
2. Dá à chave um nome (ex. servidor-producao, dev-local). O nome é só um rótulo — não afeta as permissões.
3. Clica em Criar.

O valor completo da chave é mostrado uma vez — copia-o imediatamente para o teu gestor de segredos. WallaWhats só armazena um hash mais um prefixo curto (bws_xxxxxxxx…), pelo que não pode ser recuperado depois.

Trata as chaves como passwords

Qualquer pessoa com a chave pode agir na tua conta. Guarda as chaves num gestor de segredos, nunca as faças commit ao git, e roda-as periodicamente.

Passo 3 — Usa a chave

Envia a chave no cabeçalho x-api-key em cada pedido:

curl -H "x-api-key: bws_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://api.wallawhats.com/subscriptions

Os endpoints disponíveis, corpos de pedido e formatos de resposta estão documentados na Referência da API.

Passo 4 — Rotar ou revogar

• Rotar — cria uma chave nova, implementa-a e depois apaga a antiga. Não há botão "rotar" por design; criar-depois-apagar torna a transição atómica.
• Revogar — clica em Eliminar ao lado da linha da chave. A chave deixa de funcionar imediatamente. Qualquer pedido em curso que a use retorna 401 Unauthorized.

Limites do plano

Plano	Chaves API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Se atingires o limite, Criar chave fica desativado — apaga uma chave antiga primeiro ou faz upgrade do teu plano.

Próximo passo

Para esquemas de pedido/resposta e a lista completa de endpoints, vê a Referência da API →