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.

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

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

i

Utilise 1 crédit de validation.

Arguments

  • emailstringobligatoire

    L'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

  • email

    L'adresse, sans espaces et en minuscules.

  • valid

    true uniquement si toutes les vérifications ont réussi. Provider Type et Email Provider Detection sont informatives et ne le rendent jamais false.

  • checks[].check

    Le nom de la vérification. Voir Vérifications ci-dessous.

  • checks[].status

    Passed ou Failed.

  • checks[].details

    Une phrase qui explique le résultat, prête à être montrée à un utilisateur.

  • checks[].fullResponse

    Uniquement sur Email Deliverability : la réponse exacte du serveur de la boîte.

  • checks[].providerId / providerName

    Uniquement 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 Validation

    L'adresse a un format valide. En cas d'échec, rien d'autre ne s'exécute.

  • Local Part Validation

    La partie avant @ respecte la RFC 5322 (longueur, points, caractères).

  • Role-based Email Check

    Informative : indique s'il s'agit d'une adresse d'équipe comme info@ ou admin@. 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 Type

    Informative : fournisseur gratuit/personnel ou domaine d'entreprise.

  • Domain Validation

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

    Informative : le fournisseur de la boîte, quand nous le connaissons.

  • Email Deliverability

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

    Uniquement 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'inscription

    Quand valid vaut false, montrez à l'utilisateur les details de la première vérification échouée.

  • Proposez la correction

    Misspelled Domain Check fournit l'adresse corrigée dans details : proposez-la en un clic.

  • Catch-all

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

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

  • CMDNO_SERVERS_AVAILABLE

    Aucun serveur de validation n'est disponible pour le moment. Rien n'a été facturé. Réessayez dans un instant.

  • CMDVALIDATION_FAILED

    Les serveurs de validation n'ont pas répondu à temps. Vos crédits ont été rendus. Réessayez.

  • CMDINTERNAL

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