Documentazione di Mailbeam

Tutto quello che ti serve per integrare la verifica delle email in tempo reale nella tua applicazione.

Mailbeam è un'API REST per controllare se un indirizzo email può davvero ricevere posta. Mandi un indirizzo a POST /v1/verify e ricevi uno stato, un punteggio e il motivo che c'è dietro, oppure mandi fino a 500.000 indirizzi a POST /v1/verify/batch e raccogli i risultati in modo asincrono. L'autenticazione è un token Bearer; non c'è nient'altro da installare.

URL di base
https://api.mailbeam.dev
Versione attuale
/v1/ — 12 mesi di preavviso di deprecazione
Autenticazione
Authorization: Bearer mb_live_…
Limite per lotto
500.000 indirizzi per lavoro

Cerchi il riferimento dell'API?

Documentazione completa degli endpoint, con schemi di richiesta e risposta ed esempi interattivi.

Vai al riferimento dell'API

Domande frequenti

L'API di Mailbeam è disponibile adesso?

Sì. L'API pubblica è disponibile per ogni account con un piano a pagamento. Trovi una chiave API pronta nel pannello la prima volta che entri: le chiavi di test funzionano subito e le verifiche live partono appena scegli un piano.

Che cosa mi serve per fare la mia prima chiamata all'API di Mailbeam?

Una chiave API, inviata come token Bearer nell'intestazione Authorization, e una richiesta JSON a un endpoint sotto https://api.mailbeam.dev/v1/. L'avvio rapido ripercorre una verifica completa dall'inizio alla fine.

Come versiona Mailbeam la sua API?

La versione attuale è v1 e tutti gli endpoint stanno sotto /v1/. Manteniamo la compatibilità all'indietro dentro una versione; i cambiamenti che la rompono vanno in una versione nuova, e la vecchia viene segnata come deprecata con almeno 12 mesi di preavviso.

Che differenza c'è fra la verifica in tempo reale e la verifica in blocco?

La verifica in tempo reale usa POST /v1/verify, risponde per un indirizzo a ogni richiesta e non conserva alcun indirizzo. La verifica in blocco usa POST /v1/verify/batch, accetta fino a 500.000 indirizzi per lavoro, gira in modo asincrono e conserva i risultati 72 ore perché tu possa raccoglierli.

Risposte verificate sul contratto dell'API il .