Email Validator : Validation
Valider des e-mails
Validez jusqu'à 50 adresses en une commande. Elles sont vérifiées en parallèle et reviennent dans l'ordre où vous les avez envoyées.
https://g.sendcorex.com/v1/tool/validatecommand: validate_emailsNécessite le scope tools:validate sur votre API key.
1 crédit par adresse distincte. Les adresses répétées sont validées et facturées une seule fois, et n'apparaissent qu'une fois dans results.
Si vos crédits ne couvrent pas toute la liste, rien n'est validé : vous recevez INSUFFICIENT_CREDITS avec le nombre nécessaire et le nombre disponible.
Arguments
emailsstring[]obligatoire1 à 50 adresses.
ex. :
["ana@acme.com", "jhon@gmial.com"]
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "validate_emails",
args: {
emails: [
"ana@acme.com",
"jhon@gmial.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_emails",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"results": [
{
"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"
}
]
},
{
"email": "jhon@gmial.com",
"valid": false,
"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": "Failed",
"details": "Possible typo. Suggested correction: jhon@gmail.com"
},
{
"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": "Failed",
"details": "Invalid domain or no MX records"
}
]
}
],
"count": 2,
"valid_count": 1,
"invalid_count": 1,
"credits_used": 2
}
}
]
}Champs de la réponse
resultsUn résultat par adresse distincte, dans l'ordre où vous les avez envoyées.
count / valid_count / invalid_countCombien ont été vérifiées, et combien sont revenues valides et invalides.
credits_usedLes crédits consommés par cette commande.
results[].emailL'adresse, sans espaces et en minuscules.
results[].validtrueuniquement si toutes les vérifications ont réussi.Provider TypeetEmail Provider Detectionsont informatives et ne le rendent jamaisfalse.results[].checks[].checkLe nom de la vérification. Voir Vérifications ci-dessous.
results[].checks[].statusPassedouFailed.results[].checks[].detailsUne phrase qui explique le résultat, prête à être montrée à un utilisateur.
results[].checks[].fullResponseUniquement sur
Email Deliverability: la réponse exacte du serveur de la boîte.results[].checks[].providerId / providerNameUniquement sur
Email Provider Detection: le fournisseur de messagerie qui héberge le domaine.
Grandes listes
Pour des milliers d'adresses, appelez cette commande par paquets de 50, l'un après l'autre, ou importez le fichier dans le dashboard (Email Validator → Lists) : il est validé en arrière-plan et vous recevez un e-mail avec le CSV une fois terminé.
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.