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
Avvio rapido
La tua prima verifica in 5 minuti.
Autenticazione
Chiavi API, token Bearer e rotazione delle chiavi.
Limiti di ritmo
Quote, intestazioni e strategia di ritentativo.
Errori
Codici di errore, struttura e come trattarli.
Webhook
Consegna di eventi in tempo reale e verifica HMAC.
SDKIn programma
Librerie ufficiali per Node, Python, PHP, Ruby e Go.
Cerchi il riferimento dell'API?
Documentazione completa degli endpoint, con schemi di richiesta e risposta ed esempi interattivi.
Vai al riferimento dell'APIVieni da un altro fornitore?
Domande frequenti
L'API di Mailbeam è disponibile adesso?
Sì. L'API pubblica è aperta a chiunque si registri. Il piano Free copre 1.000 verifiche al mese senza carta, e trovi una chiave API pronta nel pannello la prima volta che entri.
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 .