Email Validator: Validación

Validar emails

Valida hasta 50 direcciones en un comando. Se comprueban en paralelo y vuelven en el orden en que las enviaste.

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

Requiere el scope tools:validate en tu API key.

i

1 crédito por dirección distinta. Las direcciones repetidas se validan y se cobran una vez, y aparecen una vez en results.

!

Si tus créditos no cubren toda la lista, no se valida nada: recibes INSUFFICIENT_CREDITS con cuántos necesitas y cuántos tienes.

Argumentos

  • emailsstring[]obligatorio

    De 1 a 50 direcciones.

    p. ej. ["ana@acme.com", "jhon@gmial.com"]

Inicio rápido

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);

Respuesta

{
  "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
      }
    }
  ]
}

Campos de la respuesta

  • results

    Un resultado por dirección distinta, en el orden en que las enviaste.

  • count / valid_count / invalid_count

    Cuántas se comprobaron, y cuántas resultaron válidas e inválidas.

  • credits_used

    Créditos consumidos por este comando.

  • results[].email

    La dirección, sin espacios y en minúsculas.

  • results[].valid

    true solo cuando todas las comprobaciones pasaron. Provider Type y Email Provider Detection son informativas y nunca lo vuelven false.

  • results[].checks[].check

    El nombre de la comprobación. Consulta Comprobaciones más abajo.

  • results[].checks[].status

    Passed o Failed.

  • results[].checks[].details

    Una frase que explica el resultado, lista para mostrar a un usuario.

  • results[].checks[].fullResponse

    Solo en Email Deliverability: la respuesta exacta del servidor del buzón.

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

    Solo en Email Provider Detection: el proveedor de correo que aloja el dominio.

Listas grandes

Para miles de direcciones, llama a este comando en bloques de 50, uno tras otro, o sube el archivo en el dashboard (Email Validator → Lists): se valida en segundo plano y recibes un email con el CSV cuando termina.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401INVALID_API_KEY

    La API key no existe, fue revocada o se desactivó en el dashboard.

  • 429RATE_LIMITED

    Más de 75 solicitudes/s o 75 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.

  • CMDMISSING_SCOPE

    La API key no tiene `tools:validate`.

  • CMDINVALID_ARGS

    Un argumento no es válido: falta el email (o el dominio, en `check_disposable`), más de 50 emails, una dirección de más de 254 caracteres, limit fuera de rango…

  • CMDINSUFFICIENT_CREDITS

    No tienes suficientes créditos para todo el comando (créditos de validación para `validate_*`, créditos de disposable para `check_disposable`). No se comprobó nada y no se cobró nada.

  • CMDCREDITS_UNAVAILABLE

    No se pudieron leer tus créditos en este momento. No se cobró nada. Inténtalo de nuevo.

  • CMDNO_SERVERS_AVAILABLE

    No hay ningún servidor de validación disponible ahora mismo. No se cobró nada. Inténtalo de nuevo en breve.

  • CMDVALIDATION_FAILED

    Los servidores de validación no respondieron a tiempo. Se devolvieron tus créditos. Inténtalo de nuevo.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.