SDK oficiales
Mailbeam ofrecerá bibliotecas cliente oficiales para los lenguajes de servidor más comunes. Todos los SDK serán de código abierto, con licencia MIT y disponibles en GitHub.
Node.js
Paquete: @mailbeam/sdk
GitHub: github.com/mailbeam/mailbeam-node
npm install @mailbeam/sdk
# o
pnpm add @mailbeam/sdkimport Mailbeam from "@mailbeam/sdk";
const mb = new Mailbeam({ apiKey: process.env.MAILBEAM_KEY });
const result = await mb.verify("user@example.com");
console.log(result.valid, result.score);Compatible con Node.js 18+ y con runtimes edge (Cloudflare Workers, Vercel Edge, Deno).
Python
Paquete: mailbeam
GitHub: github.com/mailbeam/mailbeam-python
pip install mailbeamimport mailbeam
mb = mailbeam.Client(api_key=os.environ["MAILBEAM_KEY"])
# Asíncrono (recomendado en FastAPI, etc.)
result = await mb.verify("user@example.com")
# Síncrono
result = mb.verify_sync("user@example.com")
print(result.valid, result.score)Compatible con Python 3.9+ y con contextos asyncio y síncronos.
PHP
Paquete: mailbeam/mailbeam-php
GitHub: github.com/mailbeam/mailbeam-php
composer require mailbeam/mailbeam-phpuse Mailbeam\Client;
$mb = new Client($_ENV['MAILBEAM_KEY']);
$result = $mb->verify('user@example.com');
echo $result->valid ? 'valid' : 'invalid';
echo $result->score;Compatible con PHP 8.1+ y con Laravel, Symfony o PHP a secas.
Ruby
Paquete: mailbeam (RubyGems)
GitHub: github.com/mailbeam/mailbeam-ruby
gem install mailbeam
# o añádelo al Gemfile:
gem 'mailbeam'require 'mailbeam'
mb = Mailbeam::Client.new(api_key: ENV['MAILBEAM_KEY'])
result = mb.verify('user@example.com')
puts result.valid # => true
puts result.score # => 94Go
Módulo: github.com/mailbeam/mailbeam-go
GitHub: github.com/mailbeam/mailbeam-go
go get github.com/mailbeam/mailbeam-gopackage main
import (
"context"
"fmt"
"os"
mb "github.com/mailbeam/mailbeam-go"
)
func main() {
client := mb.NewClient(os.Getenv("MAILBEAM_KEY"))
result, err := client.Verify(context.Background(), "user@example.com")
if err != nil {
panic(err)
}
fmt.Println(result.Valid, result.Score)
}Funciones comunes a todos los SDK
Todos los SDK oficiales incluirán:
- Reintento automático con retroceso exponencial ante respuestas
429y5xx - Objetos de resultado tipados (sin analizar el JSON a mano)
- Soporte del modo de pruebas con claves
mb_test_ - Tiempos de espera y URL base configurables
- Soporte completo de TypeScript y de anotaciones de tipo
¿Falta tu lenguaje?
Aceptamos SDK de la comunidad. Abre una incidencia o una pull request en GitHub y la revisaremos para darle estatus oficial.
También puedes usar la API REST directamente: es una sola petición POST. Mira la referencia del endpoint verify.