Acesso à API

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

Passo 1 — Abra Chaves API

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

Passo 2 — Criar uma chave

1. Clique 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. Clique em Criar.

O valor completo da chave é mostrado uma vez — copie-o imediatamente para seu gerenciador de segredos. WallaWhats só armazena um hash mais um prefixo curto (bws_xxxxxxxx…), por isso não pode ser recuperado depois.

Trate as chaves como senhas

Qualquer pessoa com a chave pode agir na sua conta. Guarde as chaves em um gerenciador de segredos, nunca as subir ao git, e rotacione periodicamente.

Passo 3 — Use a chave

Envie a chave no cabeçalho x-api-key em cada requisição:

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

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

Passo 4 — Rotacionar ou revogar

• Rotacionar — crie uma chave nova, implante-a e depois apague a antiga. Não há botão "rotacionar" por design; criar-depois-deletar torna a transição atômica.
• Revogar — clique em Excluir ao lado da linha da chave. A chave para de funcionar imediatamente. Qualquer requisição em andamento usando-a retornará 401 Unauthorized.

Limites do plano

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

Se atingir o limite, Criar chave fica desabilitado — apague uma chave antiga primeiro ou faça upgrade do seu plano.

Próximo passo

Para esquemas de requisição/resposta e a lista completa de endpoints, veja a Referência da API →