Pular para o conteúdo principal
Acelere sua integração com nossos SDKs: Nossas bibliotecas oficiais facilitam as chamadas à API Bunny, com retries, tratamento de limite de taxa e erros tipados.

​
O que são os SDKs Bunny?

Os SDKs Bunny são bibliotecas cliente que encapsulam a API. Eles oferecem:
  • Interface simples: client.temporary_email.check(), client.ip_classify.check(), client.translate() e mais
  • Retries e backoff: Retentativas automáticas em erros de rede e rate limit
  • Erros tipados: Exceções para autenticação, validação, rate limit, etc.
  • Validação de entrada: Verificações no cliente antes de chamar a API

Benefícios de usar nossos SDKs

  • Menos boilerplate: Não é preciso gerenciar headers, JSON ou lógica de retry manualmente
  • Tipagem: Tipos completos em TypeScript, Python, Java e Go
  • Tratamento de erros: Exceções tipadas (ex.: RateLimitError, ValidationError)
  • Opções consistentes: Mesma URL base, timeout e retries em todas as linguagens

​
SDKs disponíveis

Python

SDK oficial para Python 3.8+, com httpx e pydantic.

TypeScript / Node.js

SDK oficial para Node.js e TypeScript, ESM e CommonJS.

Java

SDK oficial para Java 11+, Maven/Gradle, padrão builder.

Go

SDK oficial para Go, stdlib net/http, suporte a context.

PHP

SDK oficial para PHP 8.1+, Composer, cliente HTTP PSR-18.

​
Exemplos de uso

from bunnybuild import BunnyClient

client = BunnyClient("bun_sua_chave_api")

# Verificar e-mail temporário
result = client.temporary_email.check("user@tempmail.com")
if result.is_disposable:
    print("Domínio descartável:", result.domain)

# Classificar IP
result = client.ip_classify.check("8.8.8.8")
print("Classificação:", result.classification)

# Traduzir
result = client.translate(text="Hello world", from_lang="en", to="pt")
print("Traduzido:", result.translated_text)

​
Perguntas frequentes

Cada SDK fica em seu próprio repositório GitHub na organização bunny-build: sdk-python, sdk-typescript, sdk-java, sdk-go, sdk-php. Você pode instalar pelo gerenciador de pacotes ou compilar a partir do código.
Sim. Todos os SDKs fazem retry em erros de rede e em respostas 429/5xx com backoff exponencial e interpretam os headers de rate limit. Você também pode definir um callback para atualizações de rate limit.
Você pode chamar a API diretamente via HTTP. Veja a Referência da API para todos os 13 endpoints, headers e formatos de requisição/resposta.