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 è 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 .