Email Validator : Disposable
Vérifier une adresse jetable
Vous indique en quelques millisecondes si une adresse ou un domaine est jetable ou à haut risque, pour bloquer les fausses inscriptions. Il ne contacte pas le serveur de la boîte : pour cela, utilisez Validate Email.
https://g.sendcorex.com/v1/tool/validatecommand: check_disposableNécessite le scope tools:validate sur votre API key.
Utilise 1 crédit disposable (pas un crédit de validation). Les forfaits illimités ne sont jamais facturés.
Envoyez email ou domain. Avec un e-mail, la réputation de fraude de l'adresse est aussi vérifiée.
Arguments
emailstringfacultatifL'adresse à vérifier. Jusqu'à 254 caractères.
ex. :
"john@mailinator.com"domainstringfacultatifUniquement le domaine, quand vous n'avez pas l'adresse complète.
ex. :
"mailinator.com"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/tool/validate',
{
commands: [
{
command: "check_disposable",
args: {
email: "john@mailinator.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": "check_disposable",
"id": "0",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"email": "john@mailinator.com",
"domain": "mailinator.com",
"is_disposable": true,
"high_risk": true,
"code": "fully_confirmed",
"reason": "Confirmed",
"checks": [
{
"check": "Domain Blocklist Match",
"status": "Failed",
"details": "Domain found in known disposable list"
}
],
"unlimited": false,
"remaining_credits": 4999
}
}
]
}Champs de la réponse
emailL'adresse envoyée, sans espaces et en minuscules.
nullsi vous n'avez envoyé qu'undomain.domainLe domaine vérifié.
is_disposabletruepour les fournisseurs temporaires/jetables. Bloquez l'inscription.high_risktruelorsque l'adresse est jetable OU a déjà été signalée pour fraude sur Sendcorex. Bloquez-la ou envoyez-la en vérification.codefully_confirmedquand quelque chose a été trouvé,clearsinon.reasonUne courte explication du verdict.
checksLes vérifications exécutées (
check,status,details). Voir Vérifications ci-dessous.remaining_creditsLes crédits disposable restants après cette vérification.
nullsur un forfait illimité.unlimitedtruesur un forfait illimité.
Vérifications
De la moins coûteuse à la plus lente. Un domaine présent dans la blocklist répond immédiatement, sans aucune requête DNS.
Email Reputation CheckN'apparaît qu'en cas d'échec : l'adresse a été signalée pour fraude sur Sendcorex. Active
high_risk, pasis_disposable.Domain Blocklist MatchLe domaine est un fournisseur jetable connu. En cas d'échec, rien d'autre ne s'exécute : la réponse revient immédiatement.
MX Record CheckLe domaine est hébergé sur une infrastructure utilisée par des fournisseurs jetables, même s'il ne figure encore sur aucune liste.
MX Record PresentInformative : le domaine a des enregistrements MX. Un domaine sans MX ne peut pas recevoir d'e-mails (souvent une faute de frappe), mais cela seul ne le rend pas jetable.
Utiliser le résultat
Formulaires d'inscriptionAppelez-le avant de créer le compte. Quand
is_disposablevauttrue, demandez une autre adresse.Haut risquehigh_risksansis_disposablesignifie une vraie boîte signalée pour fraude sur Sendcorex. Bloquez-la ou mettez le compte en attente de vérification.Disposable vs. Validate EmailCette vérification est instantanée et peu coûteuse. Validate Email demande en plus au serveur de la boîte si l'adresse existe, ce qui prend quelques secondes : utilisez-le avant d'envoyer.
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
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.