Email Validator: Validación

Validar email

Comprueba una dirección antes de enviarle: formato, dominio, MX, proveedores temporales, errores tipográficos, spam traps y si el buzón existe de verdad.

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

Requiere el scope tools:validate en tu API key.

i

Usa 1 crédito de validación.

Argumentos

  • emailstringobligatorio

    La dirección a comprobar. Hasta 254 caracteres.

    p. ej. "ana@acme.com"

Inicio rápido

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

Respuesta

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

Campos de la respuesta

  • email

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

  • valid

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

  • checks[].check

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

  • checks[].status

    Passed o Failed.

  • checks[].details

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

  • checks[].fullResponse

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

  • checks[].providerId / providerName

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

Comprobaciones

Se ejecutan en este orden y se detienen antes cuando no tiene sentido seguir (sin MX, formato incorrecto…).

  • Format Validation

    La dirección tiene un formato válido. Si falla, no se ejecuta nada más.

  • Local Part Validation

    La parte antes de @ cumple la RFC 5322 (longitud, puntos, caracteres).

  • Role-based Email Check

    Informativa: indica si es una dirección de equipo como info@ o admin@. Nunca falla.

  • No-reply Email Check

    Falla con noreply@ y direcciones similares, que no leen lo que reciben.

  • Temporary Email Check

    Falla con proveedores desechables y temporales.

  • Misspelled Domain Check

    Falla con errores tipográficos comunes de grandes proveedores (gmial.com, hotmial.com…) y sugiere el correcto.

  • Spam Trap Check

    Falla con dominios conocidos como spam traps.

  • Provider Type

    Informativa: proveedor gratuito/personal o dominio corporativo.

  • Domain Validation

    El dominio existe y tiene registros MX.

  • Null MX Check

    Falla cuando el dominio declara que no acepta correo (RFC 7505).

  • Email Provider Detection

    Informativa: el proveedor del buzón, cuando lo conocemos.

  • Email Deliverability

    Preguntamos al servidor del buzón si la dirección existe, sin enviar nada. Solo se ejecuta cuando pasaron todas las comprobaciones anteriores.

  • Catch-all Mail Exchanger Check

    Solo para dominios corporativos. Falla cuando el servidor acepta cualquier dirección, así que no se puede confirmar el buzón.

Usar el resultado

  • Bloquea el registro

    Cuando valid sea false, muestra al usuario los details de la primera comprobación fallida.

  • Sugiere la corrección

    Misspelled Domain Check trae la dirección corregida en details: ofrécela con un clic.

  • Catch-all

    Una comprobación de catch-all fallida significa que el servidor acepta cualquier cosa. La dirección puede existir, pero nadie puede probarlo antes de enviar.

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.