Email Validator : Routes
Run Commands
Le point d'entrée pour la validation d'e-mails. Envoyez une commande par requête : validez une adresse, jusqu'à 50, ou lisez votre historique.
https://g.sendcorex.com/v1/tool/validateMême enveloppe que Logs et Contacts, mais avec exactement 1 commande par requête : une validation contacte de vrais serveurs de messagerie et peut prendre quelques secondes.
Les erreurs sont signalées dans le résultat de la commande, et le statut HTTP reste 200.
Paramètres du corps
commandsobject[]obligatoireExactement 1 commande.
commands[].commandstringobligatoirevalidate_email,validate_emailsoulist_validations.commands[].argsobjectfacultatifLes arguments de la commande.
commands[].idstringfacultatifVotre propre identifiant pour le résultat. Par défaut :
"0".
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": 1840,
"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
typeToujours
SUCCESSlorsque la requête elle-même a été acceptée.results[0].command / id / typeLa commande, votre id, et
SUCCESSouERROR.results[0].took_msLa durée de la validation. La plupart des adresses prennent de 1 à 5 secondes.
results[0].dataLa sortie de la commande. Présente uniquement lorsque
typevautSUCCESS.results[0].code / messageL'erreur. Présente uniquement lorsque
typevautERROR.
Authentification
Utilisez l'API key que vous créez dans le dashboard, sous Developers → API Keys, avec le scope tools:validate.
AuthorizationEnvoyez
Authorization: <api key>ouAuthorization: Bearer <api key>.tools:validateRequis par toutes les commandes de cette route.
Tokens de mailboxLe token du webmail ne fonctionne pas ici. Il est rejeté avec
WRONG_CREDENTIAL_TYPE.
Crédits
1 crédit par adresseChaque adresse validée utilise un crédit de validation. La même adresse deux fois dans une commande ne compte qu'une fois.
Tout ou rienSi vous n'avez pas assez de crédits pour toute la commande, rien n'est validé et rien n'est facturé (
INSUFFICIENT_CREDITS).Remboursement en cas d'échecSi les serveurs de validation échouent, les crédits de cette commande sont rendus (
VALIDATION_FAILED).L'historique est gratuitlist_validationslit ce que vous avez déjà validé et ne coûte rien.
Timeouts
Une validation interroge le vrai serveur de messagerie, elle est donc plus lente que les autres API. Réglez le timeout de votre client HTTP sur au moins 2 minutes pour validate_emails.
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.
- 400
INVALID_JSONLe corps n'est pas {"commands":[...]} ou dépasse 1 MB.
- 400
INVALID_ARGSLa requête ne contient aucune commande ou plus d'une. Cette route accepte exactement 1 commande par requête.
- 401
MISSING_AUTH_HEADERAucun header Authorization n'a été envoyé.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 401
API_KEY_EXPIREDL'API key a dépassé la date d'expiration définie dans le dashboard.
- 401
WRONG_CREDENTIAL_TYPEUn token de mailbox a été envoyé. La validation d'e-mails nécessite une API key du dashboard.
- 403
IP_NOT_ALLOWEDLa requête provient d'une IP qui ne figure pas parmi les IP autorisées de la key.
- 403
ACCOUNT_BLOCKEDLe compte est bloqué.
- 403
MISSING_SCOPELa key n'a pas `tools:validate`, donc aucune commande ne peut s'exécuter.
- 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.
- 503
AUTH_UNAVAILABLEL'authentification est temporairement indisponible. Réessayez.
- CMD
UNKNOWN_COMMANDLe nom de la commande n'existe pas.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.