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 |
| 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:
| 2 | String |
| statusReason | Indica la razón con referencia al estado de normalización y/o validación. Valores:
| 2 | String |
| transactionId | Merlin asigna un id de transacción por consulta. | 40 | String |
| nEmail | Son los datos del email validado. | – | – |
| Dirección de email validada. | 128 | String | |
| type | Valores:
| 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. |