Pular para o conteúdo principal
Chave de API: Sua credencial de acesso à API Bunny. Ela identifica sua conta e autoriza suas requisições. IMPORTANTE: Sem uma chave de API válida, as requisições serão recusadas com 401 Unauthorized.

​
Como funciona a autenticação

Todos os endpoints da API Bunny usam apenas autenticação por chave de API. Inclua o header X-API-Key em toda requisição.
HeaderObrigatórioValor
X-API-KeySimSua chave de API (começa com bun_)
Content-TypeCondicionalapplication/json (obrigatório em requisições POST)
AcceptRecomendadoapplication/json

Onde enviar a chave

Todas as requisições usam a mesma URL base (https://api.bunny.build/api/v1). O ambiente ou plano é determinado pela chave de API utilizada.

Erros de autenticação

A API retorna HTTP 401 quando:
  • A chave de API não é enviada no header
  • A chave é inválida
  • A chave foi revogada

​
Obtendo uma chave de API

  1. Acesse o Painel Bunny
  2. Complete seu perfil se solicitado
  3. Crie um token de API e copie-o. Ele é exibido apenas uma vez
  4. Guarde a chave em local seguro (ex.: variáveis de ambiente ou gerenciador de segredos)

Boas práticas de segurança

  • Armazene as chaves em variáveis de ambiente ou gerenciador de segredos
  • Nunca faça commit de chaves em controle de versão nem as exponha em código client-side
  • O Bunny nunca solicitará sua chave
  • Revogue qualquer chave que possa ter sido comprometida

​
Exemplos

# Requisição GET (Content-Type não necessário)
curl "https://api.bunny.build/api/v1/temporary-email?email=user@example.com" \
  -H "X-API-Key: bun_sua_chave_api"

# Requisição POST (Content-Type obrigatório)
curl -X POST https://api.bunny.build/api/v1/translate \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello", "from": "en", "to": "pt"}'

​
Respostas de erro

StatusSignificado
401Chave de API ausente ou inválida. Inclua o header X-API-Key válido.
402Cota excedida. Faça upgrade do plano ou aguarde o próximo período.
403Conta desativada. Entre em contato com o suporte.