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.

POSThttps://g.sendcorex.com/v1/tool/validate
i

Mê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.

i

Les erreurs sont signalées dans le résultat de la commande, et le statut HTTP reste 200.

Paramètres du corps

  • commandsobject[]obligatoire

    Exactement 1 commande.

  • commands[].commandstringobligatoire

    validate_email, validate_emails ou list_validations.

  • commands[].argsobjectfacultatif

    Les arguments de la commande.

  • commands[].idstringfacultatif

    Votre 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

  • type

    Toujours SUCCESS lorsque la requête elle-même a été acceptée.

  • results[0].command / id / type

    La commande, votre id, et SUCCESS ou ERROR.

  • results[0].took_ms

    La durée de la validation. La plupart des adresses prennent de 1 à 5 secondes.

  • results[0].data

    La sortie de la commande. Présente uniquement lorsque type vaut SUCCESS.

  • results[0].code / message

    L'erreur. Présente uniquement lorsque type vaut ERROR.

Authentification

Utilisez l'API key que vous créez dans le dashboard, sous Developers → API Keys, avec le scope tools:validate.

  • Authorization

    Envoyez Authorization: <api key> ou Authorization: Bearer <api key>.

  • tools:validate

    Requis par toutes les commandes de cette route.

  • Tokens de mailbox

    Le token du webmail ne fonctionne pas ici. Il est rejeté avec WRONG_CREDENTIAL_TYPE.

Crédits

  • 1 crédit par adresse

    Chaque 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 rien

    Si 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'échec

    Si les serveurs de validation échouent, les crédits de cette commande sont rendus (VALIDATION_FAILED).

  • L'historique est gratuit

    list_validations lit 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.

  • 400INVALID_JSON

    Le corps n'est pas {"commands":[...]} ou dépasse 1 MB.

  • 400INVALID_ARGS

    La requête ne contient aucune commande ou plus d'une. Cette route accepte exactement 1 commande par requête.

  • 401MISSING_AUTH_HEADER

    Aucun header Authorization n'a été envoyé.

  • 401INVALID_API_KEY

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

  • 401API_KEY_EXPIRED

    L'API key a dépassé la date d'expiration définie dans le dashboard.

  • 401WRONG_CREDENTIAL_TYPE

    Un token de mailbox a été envoyé. La validation d'e-mails nécessite une API key du dashboard.

  • 403IP_NOT_ALLOWED

    La requête provient d'une IP qui ne figure pas parmi les IP autorisées de la key.

  • 403ACCOUNT_BLOCKED

    Le compte est bloqué.

  • 403MISSING_SCOPE

    La key n'a pas `tools:validate`, donc aucune commande ne peut s'exécuter.

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

  • 503AUTH_UNAVAILABLE

    L'authentification est temporairement indisponible. Réessayez.

  • CMDUNKNOWN_COMMAND

    Le nom de la commande n'existe pas.

  • CMDINTERNAL

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