API de validation de la syntaxe des e-mails
Une regex côté client attrape les erreurs évidentes. Une validation RFC 5322 côté serveur attrape les cas limites — et ne peut pas être contournée.
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.
Analyse conforme à la RFC 5322
Mailbeam valide la syntaxe au regard de la norme RFC 5322. Cela couvre les parties locales entre guillemets, les caractères internationalisés et les formats rares mais valides que la plupart des regex rejettent à tort.
Normalisation des adresses
La réponse contient un champ `normalized_email` : domaine en minuscules, espaces retirés, format cohérent. Stockez la version normalisée pour éviter les comptes en double sur une même adresse.
Suggestion de correction
Les fautes de domaine courantes (gmal.com, hotmal.com, outlok.com) sont détectées et une correction est proposée. Affichez la suggestion dans votre interface avant la validation.
Un booléen syntax_check
Le booléen `syntax_check` isole le résultat de syntaxe du composite `valid`. Servez-vous-en pour distinguer un échec de syntaxe d'un échec MX ou SMTP dans votre gestion d'erreurs.
Échec immédiat sur syntaxe invalide
Quand la validation de syntaxe échoue, Mailbeam répond immédiatement — aucun appel DNS ni SMTP n'est fait. C'est la réponse la plus rapide possible, sous 5 ms.
Une application côté serveur, incontournable
Une validation côté client se désactive en coupant JavaScript ou via les outils de développement. Une validation de syntaxe côté serveur via l'API garantit que chaque adresse stockée dans votre base est conforme à la RFC.
Comment ça marche
Analyse de la chaîne
L'adresse est découpée en partie locale (avant le @) et domaine (après le @). Chaque partie est validée indépendamment au regard des règles RFC 5322.
Détection des fautes de frappe
Le domaine est comparé à un dictionnaire de domaines légitimes courants. Si une correction hautement probable existe (distance d'édition inférieure ou égale à 2), une suggestion est générée.
Normalisation appliquée
Le domaine est mis en minuscules, les espaces retirés, et la chaîne normalisée est renvoyée dans la réponse. Les étiquettes d'adressage avec + sont préservées, pas supprimées.
Retour anticipé ou pipeline complet
Si la syntaxe échoue, Mailbeam répond immédiatement avec `syntax_check: false`. Si elle passe, les autres contrôles (MX, SMTP, jetables, etc.) se poursuivent en parallèle.
Intégrez-le en quelques minutes
import java.net.http.*;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
@Service
public class EmailValidationService {
private final HttpClient http = HttpClient.newHttpClient();
private final ObjectMapper mapper = new ObjectMapper();
private final String apiKey = System.getenv("MAILBEAM_KEY");
public ValidationResult validate(String email) throws Exception {
String body = mapper.writeValueAsString(Map.of("email", email));
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://api.mailbeam.dev/v1/verify"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> resp = http.send(req, HttpResponse.BodyHandlers.ofString());
JsonNode result = mapper.readTree(resp.body());
if (!result.get("syntax_check").asBoolean()) {
String suggestion = result.has("suggestion") && !result.get("suggestion").isNull()
? result.get("suggestion").asText() : null;
throw new InvalidEmailException("Format d'adresse e-mail invalide.", suggestion);
}
return new ValidationResult(
result.get("valid").asBoolean(),
result.get("score").asInt(),
result.get("normalized_email").asText()
);
}
}Quand l'utiliser
Validation des entrées d'API côté serveur
Dans une architecture en microservices, validez les champs e-mail à chaque frontière d'API. Un contrôle de syntaxe à la passerelle empêche des données mal formées de se propager dans tout votre système.
Assainissement des imports en base
À l'import de données venues de sources externes (CSV, systèmes hérités, outils tiers), un contrôle de syntaxe repère les entrées mal formées avant qu'elles n'entrent dans votre base.
Application au formulaire d'inscription
Combinez une validation légère côté client, pour l'expérience, avec une application faisant autorité côté serveur. Le contrôle serveur attrape ce que le client rate et ne se contourne pas.
Audits de qualité des données
Sur des bases existantes avec un historique d'adresses, lancez un contrôle de syntaxe par lot pour repérer et signaler les fiches non conformes à la RFC 5322 — souvent un prérequis à la qualité des données exigée par le RGPD.
Questions fréquentes
Prêt à l'intégrer ?
L'offre gratuite inclut 1 000 vérifications par mois. Sans carte bancaire.