API de vérification d'e-mails en temps réel
Vérifiez n'importe quelle adresse en moins de 100 ms — assez vite pour valider pendant que l'utilisateur est encore sur le formulaire. Sept contrôles en parallèle, un seul résultat structuré.
Ce que Mailbeam contrôle
Chaque vérification lance 7 contrôles en parallèle et renvoie un résultat structuré en moins de 100 ms.
Temps de réponse p99 sous 100 ms
Les enregistrements MX des domaines européens et américains courants sont préchauffés dans le cache de Mailbeam. La plupart des vérifications se terminent en 40 à 80 ms. Le pire cas (domaine froid, serveur lent) reste sous 500 ms.
Sept contrôles en parallèle
Syntaxe, MX, sondage SMTP, détection des jetables, détection de rôle et identification catch-all s'exécutent simultanément — pas l'un après l'autre.
Suggestions de fautes de frappe dans la réponse
Quand un utilisateur tape « gmal.com », la réponse contient `suggestion: 'gmail.com'`. Affichez-la en ligne avant la validation du formulaire — vous récupérez le lead au lieu de le perdre.
Un résultat JSON structuré
Un seul objet de réponse porte `valid`, `score` (0 à 100), `status`, `disposable`, `role`, `suggestion` et un booléen par contrôle. Un appel, toutes les données dont vous avez besoin.
Un mode bac à sable pour les tests
Utilisez les domaines @valid.mailbeam-test.dev et @invalid.mailbeam-test.dev dans vos tests. Les appels renvoient des résultats déterministes sans consommer votre quota.
Hébergée dans l'UE, conforme au RGPD
Toute la vérification tourne à Francfort, en Allemagne. Les adresses ne sont pas conservées après un contrôle en temps réel ; les listes envoyées en masse et leurs résultats sont gardés 72 heures, puis supprimés. Adapté au traitement de données d'utilisateurs européens au titre de l'article 28 du RGPD.
Comment ça marche
POSTez l'adresse à la validation du formulaire
Envoyez l'adresse à /v1/verify en POST depuis votre gestionnaire d'inscription backend. N'appelez pas l'API depuis le navigateur — gardez votre clé côté serveur.
Les contrôles s'exécutent en parallèle
Validation de syntaxe, requête MX (depuis le cache si disponible), sondage SMTP de la boîte, comparaison à la base des jetables, détection du préfixe de rôle et détection catch-all tournent simultanément.
Le résultat arrive en moins de 100 ms
Pour les domaines en cache, la réponse complète — score par IA compris — revient en 40 à 80 ms. L'utilisateur ne perçoit aucun délai.
Répondez à l'utilisateur en ligne
Servez-vous du booléen `valid` pour accepter ou refuser la soumission. Du champ `suggestion` pour proposer une correction. Du `score` pour appliquer votre propre seuil de qualité aux cas limites.
Intégrez-le en quelques minutes
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
type VerifyRequest struct {
Email string `json:"email"`
}
type VerifyResult struct {
Valid bool `json:"valid"`
Score int `json:"score"`
Disposable bool `json:"disposable"`
Role bool `json:"role"`
Suggestion *string `json:"suggestion"`
Status string `json:"status"`
}
func verifyEmail(email string) (*VerifyResult, error) {
body, _ := json.Marshal(VerifyRequest{Email: email})
req, _ := http.NewRequest("POST", "https://api.mailbeam.dev/v1/verify", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("MAILBEAM_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
var result VerifyResult
json.NewDecoder(resp.Body).Decode(&result)
return &result, nil
}
func handleSignup(email string) error {
result, err := verifyEmail(email)
if err != nil || !result.Valid {
if result != nil && result.Suggestion != nil {
return fmt.Errorf("vouliez-vous dire %s ?", *result.Suggestion)
}
return fmt.Errorf("adresse e-mail invalide")
}
if result.Disposable {
return fmt.Errorf("les adresses e-mail temporaires ne sont pas acceptées")
}
return nil
}Quand l'utiliser
Formulaires d'inscription
Bloquez les adresses fausses et mal saisies avant qu'elles n'entrent dans votre base. Attrapez les jetables et affichez les corrections en ligne.
Champ e-mail du tunnel d'achat
Assurez-vous que la confirmation de commande atteint le client. Un contrôle de 100 ms au paiement évite la cause la plus fréquente des tickets « je n'ai jamais reçu ma confirmation ».
Inscriptions à une newsletter ou une liste d'attente
Protégez la qualité de la liste dès le premier jour. Un contrôle en temps réel garantit que chaque adresse d'abonné est délivrable avant d'entrer dans votre plateforme d'envoi.
Formulaires de demande de démo B2B
Bloquez adresses de rôle et jetables sur les formulaires de conversion à forte valeur. Servez-vous de l'indicateur `role` pour router les adresses info@ vers une revue manuelle plutôt que vers des séquences automatisées.
Questions fréquentes
La vérification va-t-elle ralentir mon formulaire d'inscription ?
Non. À moins de 100 ms au p99, la vérification se termine plus vite que l'aller-retour réseau de la plupart des soumissions. Les utilisateurs ne perçoivent aucun délai supplémentaire.
Faut-il vérifier côté frontend ou backend ?
Toujours depuis votre backend — jamais depuis du JavaScript côté navigateur. Cela garde votre clé d'API secrète et empêche qu'un script côté client contourne le contrôle.
Que faire si Mailbeam renvoie le statut « unknown » ?
« Unknown » signifie que Mailbeam n'a pas pu établir la délivrabilité avec certitude — en général parce que le serveur bloque les sondages SMTP (fréquent chez Google et Microsoft). Le champ `score` donne un indicateur de confiance. Pour une adresse inconnue avec un score de 50 ou plus, envisagez d'accepter l'inscription et de surveiller les bounces.
Peut-on combiner vérification en temps réel et lien de confirmation ?
Oui, et nous le recommandons. La vérification en temps réel attrape immédiatement les fautes de frappe et les jetables. Le lien de confirmation prouve que l'utilisateur contrôle la boîte. Utilisez les deux pour la base d'utilisateurs de la meilleure qualité.
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.