Autenticação

A API do BotGate utiliza a autenticação baseada em Bearer Tokens. Todas as requisições para endpoints restritos devem incluir sua chave de API nos headers.

Como obter sua API Key

1. Acesse o painel do seu bot no site do BotGate.
2. Vá até a seção Configurações.
3. Copie o valor no campo Chave de API.

Importante

Sua chave de API é secreta. Nunca a compartilhe publicamente ou a inclua no código-fonte do seu bot se ele for open-source. Use variáveis de ambiente (como .env) para protegê-la.

Enviando no Header

Para autenticar sua requisição, adicione o cabeçalho Authorization com o prefixo Bearer seguido da sua chave.

Authorization: Bearer <sua_api_key>

Exemplo com Fetch (Node.js)

fetch("https://botgate-api-987684559046.us-central1.run.app/api/v1/verify", {
  headers: {
    Authorization: "Bearer 7e89...d230",
  },
});

Erros Comuns

Status	Motivo
401 Unauthorized	Chave de API ausente ou inválida.
403 Forbidden	A chave de API pertence a outro bot ou o bot não está aprovado.