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/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 Node.js 18+ et runtimes edge (Cloudflare Workers, Vercel Edge, Deno).
Python
Paquet : mailbeam
GitHub : github.com/mailbeam/mailbeam-python
pip install mailbeamimport 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-phpuse 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 # => 94Go
Module : 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)
}Ce que tous les SDK partagent
Tous les SDK officiels comprennent :
- Un réessai automatique avec backoff exponentiel sur les réponses
429et5xx - 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.