Inicio

Última Actualización: 07 Agosto del 2021

Introducción

Con esta API se puede validar un correo electrónico, mediante un algoritmo que detecta los servidores de correo del dominio dado. la api nos da resultado de los siguientes puntos.

Validación de estructura
Validación de conexión al dominio/IP
Validación SMTP
Validación de registros MX
Validación de correo desechable/temporal
Validación de blacklist personalizado
Todos los métodos disponibles de la API reciben la petición por GET, por lo que podrás probar directo en tu navegador.

Registro

Se deberá registrar de forma gratuita y crear un proyecto. En este proyecto se generará un token que deberá enviar en una variable tipo GET para realizar su consulta. Para crear su cuenta deberá acceder a la siguiente URL:
https://validacion.email/api/registro

Respuesta del servidor

Una vez que se haya hecho el request, el servidor regresará un código 200 http si todo salió de forma correcta, o devolverá un código 400 http si hubo un error en el envío de los parámetros al endpoint. En cualquier caso devolverá un json.

Validación

Endpoint de validación

Para acceder a la API, se deberá ingresar al siguiente ENDPOINT:

https://validacion.email/query/validate/{email}?token={token}&validate_disposable={validate_disposable}

  • En donde {email} será el correo electrónico a validar.
  • En donde {token} será una variable tipo GET obligatoria, con el que identificará su proyecto.
  • En donde {validate_disposable} será una variable tipo GET opcional, si se desea verificar si el correo es un correo desechable, se deberá ingresar 1, de lo contrario se deberá ingresar 0 u omitir enviar la variable.

Validar un correo electrónico

Para validar un correo se deberá acceder al método {validate}, enviar en la url el correo a validar y se deberá mandar el token de proyecto de forma obligatoria.
Ejemplo:

https://validacion.email/query/validate/correo@dominio.com?token=TOKEN


A esto nos devolverá un JSON con el análisis y los resultados de la validación.


											
											
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "is_error": false,
        "message_warning": [],
        "syntax": "correct",
        "user": "correo",
        "domain": "dominio.com",
        "domain_exists": true,
        "ip": [
            "65.254.244.176"
        ],
        "mx_record": "correct",
        "mx_record_value": [
            "mx.dominio.com"
        ],
        "http_code": 301,
        "disposable": null,
        
    }
}

Validar un correo electrónico y validar desechable/temporal

Para validar un correo se deberá acceder al método {validate}, enviar en la url el correo a validar y se deberá mandar el token de proyecto de forma obligatoria y se deberá ingresar la variable {validate_disposable} con el valor de 1
Ejemplo:

https://validacion.email/query/validate/correo@dominio.com?token=TOKEN&validate_disposable=1


A esto nos devolverá un JSON con el análisis y los resultados de la validación.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "is_error": false,
        "message_warning": [],
        "syntax": "correct",
        "user": "correo",
        "domain": "dominio.com",
        "domain_exists": true,
        "ip": [
            "65.254.244.176"
        ],
        "mx_record": "correct",
        "mx_record_value": [
            "mx.dominio.com"
        ],
        "http_code": 301,
        "disposable": false,
        
    }
}

Validar un correo electrónico, validar desechable/temporal y verificar existencia

Para validar un correo se deberá acceder al método {validate}, enviar en la url el correo a validar, se deberá mandar el token de proyecto de forma obligatoria, se deberá ingresar la variable {validate_disposable} con el valor de 1 y se deberá enviar la variable {validate_} con el valor de 1
Ejemplo:

https://validacion.email/query/validate/correo@dominio.com?token=TOKEN&validate_disposable=1


A esto nos devolverá un JSON con el análisis y los resultados de la validación.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "is_error": false,
        "message_warning": [],
        "syntax": "correct",
        "user": "correoj",
        "domain": "",
        "domain_exists": true,
        "ip": [
            "172.217.15.5"
        ],
        "mx_record": "correct",
        "mx_record_value":
        "http_code": 301,
        "disposable": false,
        
    }
}

Blacklist

El sistema es capaz de crear un blacklist personalizado por cuenta, es decir, usted puede agregar un dominio o correo su blacklist y aplicará la validación a todos sus proyectos creados.

Endpoint de blacklist

Para hacer una solicitud a su propio blacklist, se deberá ingresar al siguiente ENDPOINT:

https://validacion.email/blacklist/{metodo}/{tipo}/{valor}?token_user={token_user}&search={search}

  • En donde {metodo} será el método/función que realizará la api. Los disponibles son:
    • add: Agrega un elemento al blacklist personalizado
    • delete: Borra un elemento al blacklist personalizado
    • list: Muestra los elementos del blacklist personalizado
    • general_list: Muestra los últimos 50 elementos del blacklist general (dominios desechables/temporales)
  • En donde {tipo} será el elemento que desea. Los disponibles son:
    • domain: Dominio
    • email: Correo
  • En donde {valor} será un correo o un dominio para realizar una acción con el método
  • En donde {token_user} será una variable tipo get obligatoria, token_user será único por cuenta, independiente al token de proyecto
  • En donde {search} será una variable tipo get opcional, dependiendo el método a usar, se podrá enviar

Agregar un dominio al blacklist personalizado

Para agregar un dominio a su blacklist se deberá acceder al método {add}, al tipo {domain}, enviar el {valor} en la url el dominio a bloquear y se deberá mandar la variable get del token de usuario de forma obligatoria.
Ejemplo:

https://validacion.email/blacklist/add/domain/dominiospam.com?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "message": "Se ha agregado el dominio a su blacklist"
    }
}

Agregar un correo al blacklist personalizado

Para agregar un correo a su blacklist se deberá acceder al método {add}, al tipo {email}, enviar el {valor} en la url el correo a bloquear y se deberá mandar la variable get del token de usuario de forma obligatoria.
Ejemplo:

https://validacion.email/blacklist/add/email/correo@dominiospam.com?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "message": "Se ha agregado el email a su blacklist"
    }
}

Eliminar un dominio del blacklist personalizado

Para eliminar un dominio de su blacklist se deberá enviar el método {delete}, el tipo {domain}, enviar el {valor} en la url el dominio a eliminar del blacklist y se deberá mandar la variable get del token de usuario de forma obligatoria.
Ejemplo:

https://validacion.email/blacklist/delete/domain/dominiospam.com?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "message": "Se ha borrado el dominio de su blacklist"
    }
}

Eliminar un email del blacklist personalizado

Para eliminar un email de su blacklist se deberá enviar el método {delete}, el tipo {email}, enviar el {valor} en la url el correo a eliminar del blacklist y se deberá mandar la variable get del token de usuario de forma obligatoria.
Ejemplo:

https://validacion.email/blacklist/delete/email/correo@dominiospam.com?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "message": "Se ha borrado el email de su blacklist"
    }
}

Listar dominio del blacklist personalizado

Para listar los dominios de su blacklist personalizado se deberá enviar el método {list}, el tipo {domain}, se deberá enviar la variable get del token de usuario de forma obligatoria. De forma opcional se puede mandar un limitador de resultados en la variable get {limit} y se puede realizar una búsqueda de dominio por medio de la variable get {search}

{limit} Es una variable get, si no se envía el sistema por automático le asignará el valor de 50.
{search} Es una variable get, si no se envía el sistema mostrará todos los resultados sin filtrarlos por búsqueda.

Ejemplo sencillo:

https://validacion.email/blacklist/list/domain?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "domain_blacklist": [
            "cero.com",
            "dominiospam.com",
            "blacklist.mx"
        ]
    }
}
Ejemplo con limitador:

https://validacion.email/blacklist/list/domain?token_user=TOKEN&limit=100


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "domain_blacklist": [
            "blacklist.mx",
            "dominiospam.com"
            ...
            ...
            "otro.com",
            "cero.com"
        ]
    }
}
Ejemplo con limitador y búsqueda:

https://validacion.email/blacklist/list/domain?token_user=TOKEN&limit=10&search=spam


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "domain_blacklist": [
            "dominiospam.com"
        ]
    }
}

Listar correos del blacklist personalizado

Para listar los correos de su blacklist personalizado se deberá enviar el método {list}, el tipo {email}, se deberá mandar la variable get del token de usuario de forma obligatoria. De forma opcional se puede mandar un limitador de resultados en la variable get {limit} y se puede realizar una búsqueda de dominio por medio de la variable get {search}

{limit} Es una variable get, si no se envía el sistema por automático le asignará el valor de 50.
{search} Es una variable get, si no se envía el sistema mostrará todos los resultados sin filtrarlos por búsqueda.

Ejemplo sencillo:

https://validacion.email/blacklist/list/email?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "email_blacklist": [
            "correo@dominiospam.com",
            "usar@blacklist.mx",
            "spam@cero.com"
        ]
    }
}
Ejemplo con limitador:

https://validacion.email/blacklist/list/email?token_user=TOKEN&limit=100


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "email_blacklist": [
            "correo@dominiospam.com",
            "usar@blacklist.mx",
            ...
            ...
            "spam@cero.com"
            "asd@otro.com"
        ]
    }
}
Ejemplo con limitador y búsqueda:

https://validacion.email/blacklist/list/email?token_user=TOKEN&limit=10&search=spam


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "email_blacklist": [
            "correo@dominiospam.com",
            "spam@cero.com"
        ]
    }
}

Buscar dominio del blacklist General

Actualmente contamos con una base de datos de más de 130 mil dominios en lista negra. Por lo cual ponemos a su disposición esta herramienta para buscar los dominios en nuestra base de datos. Para buscar un dominio en el blacklist general, se deberá enviar el método {general_list}, el tipo {domain}, se deberá mandar la variable get del token de usuario de forma obligatoria. De forma opcional se puede mandar un limitador de resultados en la variable get {limit} y se puede realizar una búsqueda de dominio por medio de la variable get {search}

{limit} Es una variable get, si no se envía el sistema por automático le asignará el valor de 50. Si ingresa un valor mayor a 50 se adignará 50 como máximo.
{search} Es una variable get, si no se envía el sistema mostrará todos los resultados sin filtrarlos por búsqueda.

Ejemplo sencillo:

https://validacion.email/blacklist/general_list/domain?token_user=TOKEN


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "domain_blacklist": [
            "gocasin.com",
            "biyac.com",
            ...
            ...
            ...
            "givmail.com",
            "inboxmail.com",
            "zetmail.com",
        ]
    }
}


Ejemplo con limitador:

https://validacion.email/blacklist/general_list/domain?token_user=TOKEN&limit=10


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "domain_blacklist": [
            "gocasin.com",
            "kucix.com",
            "yopmail.com",
            "biyac.com",
            "mozej.com",
            "mailna.co",
            "mailna.in",
            "mailna.me",
            "mohmal.im",
            "mohmal.in"
        ]
    }
}


Ejemplo con limitador:

https://validacion.email/blacklist/general_list/domain?token_user=TOKEN&limit=10&search=spam


A esto nos devolverá un JSON con la respuesta de la solicitud.


                                            
                                            
{
    "error": false,
    "error_code": 0,
    "error_message": "",
    "response": {
        "domain_blacklist": [
            "spam4.me",
            "spambog.com",
            "spambog.de",
            "spambog.ru",
            "spamgourmet.com",
            "antispam.de",
            "antispammail.de",
            "bspamfree.org",
            "deadspam.com",
            "despam.it"
        ]
    }
}

Códigos de Error API

Una vez que se haya hecho el request, el servidor regresará un código http 400 si hubo un error en el envío de los parametros al endpoint.

En la siguiente tabla, se enlistan los códigos de error:

Validación

Código Descripción API Método
1 La IP ha sido bloqueada por que no cumple con nuestros términos y condiciones General N/A
2 No se recibió el token del proyecto Validación N/A
3 El token del proyecto es inválido Validación N/A
4 Se han agotado sus consultas Validación N/A
5 Su proyecto se encuentra en estatus: Suspendido Validación N/A
6 El valor de la variable "validate_disposable" es inválido Validación N/A
7 El valor de la variable "" es inválido Validación N/A
8 No se recibió el correo a validar Validación validate
9 El correo esta en blacklist personalizad Validación validate
10 La sintaxis del correo es inválida Validación validate
11 El correo tiene algunas inconsistencias Validación validate

Blacklist

Código Descripción API Método Tipo
101 No se recibió el token del usuario Blacklist N/A N/A
102 La acción es inválida Blacklist N/A N/A
103 El tipo es inválido Blacklist N/A N/A
104 No se recibió el valor de la acción Blacklist N/A N/A
105 El token del su usuario es inválido Blacklist N/A N/A
106 Se han agotado sus consultas Blacklist N/A N/A
107 Su cuenta se encuentra en estatus: Suspendido Blacklist N/A N/A
201 El dominio es inválido Blacklist add domain
202 El dominio que intenta agregar, ya existe Blacklist add domain
301 El email es inválido Blacklist add email
302 El email que intenta agregar, ya existe Blacklist add email
401 El dominio es inválido Blacklist delete domain
402 El dominio que intenta borrar no exist Blacklist delete domain
501 El email es inválido Blacklist delete email
502 El email que intenta borrar no existe Blacklist delete email
601 El limitador de resultados es inválido Blacklist list domain
602 No se encontró información con los datos proporcionados Blacklist list domain
701 El limitador de resultados es inválido Blacklist list email
702 No se encontró información con los datos proporcionados Blacklist list email
801 El limitador de resultados es inválido Blacklist general_list domain
802 No se encontró información con los datos proporcionados Blacklist general_list domain
901 Solo se admite "domain" en tipo Blacklist general_list N/A

Changelog

En esta sección aparecerán los cambios hechos en la API, desde el día de su publicación

  • 7/07/2021 - Se agregó blacklist
  • 9/05/2021 - Creación y publicación de la API