Beta privataMailbeam è in beta privata: l'API pubblica non è ancora aperta.Iscriviti alla lista d'attesa

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/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);

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

Go

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

Funzioni comuni a tutti gli SDK

Tutti gli SDK ufficiali includeranno:

  • Ritentativo automatico con rallentamento esponenziale davanti alle risposte 429 e 5xx
  • 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.