Bêta privéeMailbeam est en bêta privée : l'API publique n'est pas encore ouverte.Rejoindre la liste d'attente

SDK officiels

Mailbeam fournira des bibliothèques clientes officielles pour les langages serveur les plus répandus. Tous les SDK sont open source, sous licence MIT, et disponibles sur GitHub.

Node.js

Paquet : @mailbeam/sdk
GitHub : github.com/mailbeam/mailbeam-node

npm install @mailbeam/sdk
# ou
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 Node.js 18+ et runtimes edge (Cloudflare Workers, Vercel Edge, Deno).

Python

Paquet : mailbeam
GitHub : github.com/mailbeam/mailbeam-python

pip install mailbeam
import mailbeam

mb = mailbeam.Client(api_key=os.environ["MAILBEAM_KEY"])

# Asynchrone (recommandé pour FastAPI, etc.)
result = await mb.verify("user@example.com")

# Synchrone
result = mb.verify_sync("user@example.com")
print(result.valid, result.score)

Compatible Python 3.9+, en contexte asyncio comme en synchrone.

PHP

Paquet : 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 PHP 8.1+, avec Laravel, Symfony ou du PHP nu.

Ruby

Paquet : mailbeam (RubyGems)
GitHub : github.com/mailbeam/mailbeam-ruby

gem install mailbeam
# ou dans le 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

Module : 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)
}

Ce que tous les SDK partagent

Tous les SDK officiels comprennent :

  • Un réessai automatique avec backoff exponentiel sur les réponses 429 et 5xx
  • Des objets de résultat typés (aucune analyse JSON à la main)
  • La prise en charge du mode test via les clés d'API mb_test_
  • Des délais d'expiration et des URL de base configurables
  • Un typage complet (TypeScript, annotations de type)

Votre langage n'y est pas ?

Nous acceptons les SDK contribués par la communauté. Ouvrez une issue ou une pull request sur GitHub et nous examinerons son passage en support officiel.

Vous pouvez aussi appeler directement l'API REST : c'est une simple requête POST. Voyez la référence de l'endpoint verify.