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.

POSThttps://g.sendcorex.com/v1/tool/validatecommand: check_disposable
i

Nécessite le scope tools:validate sur votre API key.

i

Utilise 1 crédit disposable (pas un crédit de validation). Les forfaits illimités ne sont jamais facturés.

i

Envoyez email ou domain. Avec un e-mail, la réputation de fraude de l'adresse est aussi vérifiée.

Arguments

  • emailstringfacultatif

    L'adresse à vérifier. Jusqu'à 254 caractères.

    ex. : "john@mailinator.com"

  • domainstringfacultatif

    Uniquement 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

  • email

    L'adresse envoyée, sans espaces et en minuscules. null si vous n'avez envoyé qu'un domain.

  • domain

    Le domaine vérifié.

  • is_disposable

    true pour les fournisseurs temporaires/jetables. Bloquez l'inscription.

  • high_risk

    true lorsque l'adresse est jetable OU a déjà été signalée pour fraude sur Sendcorex. Bloquez-la ou envoyez-la en vérification.

  • code

    fully_confirmed quand quelque chose a été trouvé, clear sinon.

  • reason

    Une courte explication du verdict.

  • checks

    Les vérifications exécutées (check, status, details). Voir Vérifications ci-dessous.

  • remaining_credits

    Les crédits disposable restants après cette vérification. null sur un forfait illimité.

  • unlimited

    true sur 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 Check

    N'apparaît qu'en cas d'échec : l'adresse a été signalée pour fraude sur Sendcorex. Active high_risk, pas is_disposable.

  • Domain Blocklist Match

    Le 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 Check

    Le 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 Present

    Informative : 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'inscription

    Appelez-le avant de créer le compte. Quand is_disposable vaut true, demandez une autre adresse.

  • Haut risque

    high_risk sans is_disposable signifie une vraie boîte signalée pour fraude sur Sendcorex. Bloquez-la ou mettez le compte en attente de vérification.

  • Disposable vs. Validate Email

    Cette 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.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus 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.

  • CMDMISSING_SCOPE

    L'API key n'a pas `tools:validate`.

  • CMDINVALID_ARGS

    Un 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…

  • CMDINSUFFICIENT_CREDITS

    Vous 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é.

  • CMDCREDITS_UNAVAILABLE

    Vos crédits n'ont pas pu être lus pour le moment. Rien n'a été facturé. Réessayez.

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.