SDK ufficiali
Mailbeam offrirà librerie client ufficiali per i linguaggi lato server più comuni. Tutti gli SDK saranno a codice aperto, con licenza MIT e disponibili su GitHub.
Node.js
Pacchetto: @mailbeam/sdk
GitHub: github.com/mailbeam/mailbeam-node
npm install @mailbeam/sdk
# oppure
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);Compatibile con Node.js 18+ e con i runtime edge (Cloudflare Workers, Vercel Edge, Deno).
Python
Pacchetto: mailbeam
GitHub: github.com/mailbeam/mailbeam-python
pip install mailbeamimport mailbeam
mb = mailbeam.Client(api_key=os.environ["MAILBEAM_KEY"])
# Asincrono (consigliato in FastAPI, eccetera)
result = await mb.verify("user@example.com")
# Sincrono
result = mb.verify_sync("user@example.com")
print(result.valid, result.score)Compatibile con Python 3.9+ e con contesti asyncio e sincroni.
PHP
Pacchetto: 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;Compatibile con PHP 8.1+ e con Laravel, Symfony o PHP puro e semplice.
Ruby
Pacchetto: mailbeam (RubyGems)
GitHub: github.com/mailbeam/mailbeam-ruby
gem install mailbeam
# oppure aggiungilo 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
Modulo: 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)
}Funzioni comuni a tutti gli SDK
Tutti gli SDK ufficiali includeranno:
- Ritentativo automatico con rallentamento esponenziale davanti alle risposte
429e5xx - Oggetti di risultato tipizzati (senza analizzare il JSON a mano)
- Supporto della modalità di prova con chiavi
mb_test_ - Tempi di attesa e URL di base configurabili
- Supporto completo di TypeScript e delle annotazioni di tipo
Manca il tuo linguaggio?
Accettiamo SDK dalla comunità. Apri una segnalazione o una pull request su GitHub e la valuteremo per darle lo stato di ufficiale.
Puoi anche usare l'API REST direttamente: è una sola richiesta POST. Vedi il riferimento dell'endpoint verify.