Email Validator : Validation
Valider un e-mail
Vérifiez une adresse avant de lui écrire : format, domaine, MX, fournisseurs temporaires, fautes de frappe, spam traps et existence réelle de la boîte.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailNécessite le scope tools:validate sur votre API key.
Utilise 1 crédit de validation.
Arguments
emailstringobligatoireL'adresse à vérifier. Jusqu'à 254 caractères.
ex. :
"ana@acme.com"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "validate_email",
args: {
email: "ana@acme.com"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "validate_email",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"email": "ana@acme.com",
"valid": true,
"checks": [
{
"check": "Format Validation",
"status": "Passed",
"details": "Valid email format"
},
{
"check": "Local Part Validation",
"status": "Passed",
"details": "Local part is RFC compliant"
},
{
"check": "Role-based Email Check",
"status": "Passed",
"details": "Not a role-based address"
},
{
"check": "No-reply Email Check",
"status": "Passed",
"details": "Not a no-reply address"
},
{
"check": "Temporary Email Check",
"status": "Passed",
"details": "Not a temporary email"
},
{
"check": "Misspelled Domain Check",
"status": "Passed",
"details": "Correct"
},
{
"check": "Spam Trap Check",
"status": "Passed",
"details": "Not a spam trap"
},
{
"check": "Provider Type",
"status": "Passed",
"details": "Corporate or custom domain"
},
{
"check": "Domain Validation",
"status": "Passed",
"details": "Domain is valid and has MX records"
},
{
"check": "Null MX Check",
"status": "Passed",
"details": "Domain accepts email"
},
{
"check": "Email Provider Detection",
"status": "Passed",
"details": "Domain is hosted on a known provider: Google Workspace",
"providerId": 1,
"providerName": "Google Workspace"
},
{
"check": "Email Deliverability",
"status": "Passed",
"details": "Mailbox exists",
"fullResponse": "250 2.1.5 OK"
},
{
"check": "Catch-all Mail Exchanger Check",
"status": "Passed",
"details": "Mail exchanger correctly rejects nonexistent addresses"
}
]
}
}
]
}Champs de la réponse
emailL'adresse, sans espaces et en minuscules.
validtrueuniquement si toutes les vérifications ont réussi.Provider TypeetEmail Provider Detectionsont informatives et ne le rendent jamaisfalse.checks[].checkLe nom de la vérification. Voir Vérifications ci-dessous.
checks[].statusPassedouFailed.checks[].detailsUne phrase qui explique le résultat, prête à être montrée à un utilisateur.
checks[].fullResponseUniquement sur
Email Deliverability: la réponse exacte du serveur de la boîte.checks[].providerId / providerNameUniquement sur
Email Provider Detection: le fournisseur de messagerie qui héberge le domaine.
Vérifications
Elles s'exécutent dans cet ordre et s'arrêtent tôt quand continuer n'a pas de sens (pas de MX, format incorrect…).
Format ValidationL'adresse a un format valide. En cas d'échec, rien d'autre ne s'exécute.
Local Part ValidationLa partie avant
@respecte la RFC 5322 (longueur, points, caractères).Role-based Email CheckInformative : indique s'il s'agit d'une adresse d'équipe comme
info@ouadmin@. N'échoue jamais.No-reply Email CheckÉchoue pour
noreply@et les adresses similaires, qui ne lisent pas ce qu'elles reçoivent.Temporary Email CheckÉchoue pour les fournisseurs jetables et temporaires.
Misspelled Domain CheckÉchoue pour les fautes de frappe courantes des grands fournisseurs (
gmial.com,hotmial.com…) et propose le bon domaine.Spam Trap CheckÉchoue pour les domaines connus comme spam traps.
Provider TypeInformative : fournisseur gratuit/personnel ou domaine d'entreprise.
Domain ValidationLe domaine existe et a des enregistrements MX.
Null MX CheckÉchoue lorsque le domaine déclare ne pas accepter d'e-mails (RFC 7505).
Email Provider DetectionInformative : le fournisseur de la boîte, quand nous le connaissons.
Email DeliverabilityNous demandons au serveur de la boîte si l'adresse existe, sans rien envoyer. Ne s'exécute que si toutes les vérifications ci-dessus ont réussi.
Catch-all Mail Exchanger CheckUniquement pour les domaines d'entreprise. Échoue lorsque le serveur accepte n'importe quelle adresse : la boîte ne peut donc pas être confirmée.
Utiliser le résultat
Bloquez l'inscriptionQuand
validvautfalse, montrez à l'utilisateur lesdetailsde la première vérification échouée.Proposez la correctionMisspelled Domain Checkfournit l'adresse corrigée dansdetails: proposez-la en un clic.Catch-allUne vérification catch-all échouée signifie que le serveur accepte tout. L'adresse peut exister, mais personne ne peut le prouver avant l'envoi.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 75 requêtes/s ou 75 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas `tools:validate`.
- CMD
INVALID_ARGSUn argument est invalide : e-mail manquant (ou domaine, pour `check_disposable`), plus de 50 e-mails, une adresse de plus de 254 caractères, limit hors limites…
- CMD
INSUFFICIENT_CREDITSVous n'avez pas assez de crédits pour toute la commande (crédits de validation pour `validate_*`, crédits disposable pour `check_disposable`). Rien n'a été vérifié et rien n'a été facturé.
- CMD
CREDITS_UNAVAILABLEVos crédits n'ont pas pu être lus pour le moment. Rien n'a été facturé. Réessayez.
- CMD
NO_SERVERS_AVAILABLEAucun serveur de validation n'est disponible pour le moment. Rien n'a été facturé. Réessayez dans un instant.
- CMD
VALIDATION_FAILEDLes serveurs de validation n'ont pas répondu à temps. Vos crédits ont été rendus. Réessayez.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.