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.

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

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

i

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[]obligatoire

    1 à 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

  • results

    Un résultat par adresse distincte, dans l'ordre où vous les avez envoyées.

  • count / valid_count / invalid_count

    Combien ont été vérifiées, et combien sont revenues valides et invalides.

  • credits_used

    Les crédits consommés par cette commande.

  • results[].email

    L'adresse, sans espaces et en minuscules.

  • results[].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.

  • results[].checks[].check

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

  • results[].checks[].status

    Passed ou Failed.

  • results[].checks[].details

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

  • results[].checks[].fullResponse

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

  • results[].checks[].providerId / providerName

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

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