API de servicios

Tema Anterior
Próximo Tema

Validador de Email

API de servicios Servicios JSON 2.5 Validador de Email

Validador de Email

Servicio de Validación de Email (Email Normalize)

El cliente debe enviar una estructura de datos según lo detallado en el apartado Parámetros de Llamada» debiendo completar mínimamente los campos que se detallan a continuación:

  • email: deberá completarse con el email que se requiere validar.

Los siguientes campos son los Headers Obligatorios que deben informarse:

  • Authorization: Header con el ID de acceso de cliente (ClientAccessCode).
  • Content-Type: Header que se informa el tipo de contenido del mensaje, se debe informar application/json.

Método: GET

Endpoint: https://ws.merlindataquality.com/email/normalize

Parámetros de llamada
Parámetro Descripción Longitud Tipo
email Dirección de correo electrónico. 128 String
Mensaje JSON de petición
{ 
"email": "egoncalves@asesconsulting.com" 
}
Respuesta

La respuesta está compuesta por una lista de elementos que tienen la siguiente estructura:

Parámetro Descripción Longitud Tipo
status Indica el estado de normalización y/o validación.
Valores:

  • VA (Validado): Email validado.
  • NV (No Validado): Email no validado. (NOTA: Este estado no quiere decir que el Email es invalido, solo que para ese momento no fue validado, un Email es invalido cuando resulte algunos de los siguientes motivos: EI o ES). Ver tabla de motivos NV.
 2 String
statusReason Indica la razón con referencia al estado de normalización y/o validación.
Valores:

  • SM: Sin Motivo
 2 String
transactionId Merlin asigna un id de transacción por consulta. 40 String
nEmail Son los datos del email validado. – –
email Dirección de email validada. 128 String
type Valores:

  • Tipo laboral (L)
  • Personal (P)
  • No Determinado (ND)
 2 String
lastDateValidated Indica la fecha de la última validación de ese email contra el servicio en línea. 10 String
merlinCustomValues Valores desarrollados por demanda del cliente o que se proveen opcionalmente. – Object
Mensaje JSON de respuesta
{
    "status": "VA",
    "statusReason": "SM",
    "transactionId": "d7aff604-16a2-42c6-bcd1-0a2d16a77a48",
    "nEmail": {
        "email": "egoncalves@asesconsulting.com",
        "type": "ND",
        "lastDateValidated": "2020-08-31",
        "merlinCustomValues": {}
    }
}
Tabla de estados NV
Atributo Significado Descripción
EI Email Invalido La cuenta de correo electrónico no existe.
EG Error General La entrega falla porque se produjo un problema de retransmisión.
ES Error Sintaxis Hay un error de sintaxis en la dirección de correo electrónico.
SS Sin Servidor La respuesta SMTP del servidor no es válida, el servidor de destino nos informó de un error interno.
DE Error Dominio El servidor de correo electrónico está caído y no existe ninguna conexión con él.
ED Error Desconocido Este error se puede generar por varios motivos, una tecnología anti-spam está bloqueando el progreso de verificación, también puede ser que la cuenta de correo electrónico está suspendida / limitada y no puede recibir mensajes de correo electrónico o el correo electrónico es una dirección temporal.
DV Dominio Válido Este estado informa que la casilla de email no se pudo validar, pero el dominio donde se encuentra el servidor de correos es válido y existe.
Tema Anterior
Volver a la Lección
Próximo Tema