Beta privadaMailbeam está en beta privada: la API pública todavía no está abierta.Únete a la lista de espera

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/sdk
import 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 mailbeam
import 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-php
use 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   # => 94

Go

Módulo: github.com/mailbeam/mailbeam-go
GitHub: github.com/mailbeam/mailbeam-go

go get github.com/mailbeam/mailbeam-go
package 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 429 y 5xx
  • 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.