Detalle de la API

Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:

• Endpoint: https://cont.certisend.com/web/container/api/v1/validations/ip/blacklisted

Parámetros:

• token-susc: Token obtenido al momento de la suscripción a nivel empresa.
• token-api: Token obtenido al momento de la suscripción a nivel API.
• ip: IP a validar.
• internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.

La llamada quedaría de la siguiente manera:
https://cont.certisend.com/web/container/api/v1/validations/ip/blacklisted?token-susc=TOKENSUSC&token-api=TOKENAPI&ip=1&internalid=16

Una vez realizada la llamada van a recibir los siguientes parámetros:

• state: Tendrá el valor 0:(desconocido/error.), 1:(ok/validado correctamente.), 2:(error sintaxis / error guardado en cache.).
• dnsb1-1.uceprotect.net: dnsb1-1.uceprotect.net
• dnsbl-2.uceprotect.net: dnsbl-2.uceprotect.net
• dnsbl-3uceprotect.net: dnsbl-3uceprotect.net
• dnsbl.dronebl.org: dnsbl.dronebl.org
• dnsbl.sorbs.net: dnsbl.sorbs.net
• zen.spamhaus.org: zen.spamhaus.org
• bl.spamcop.net: bl.spamcop.net
• list.dsbl.org: list.dsbl.org
• sbl.spamhaus.org: sbl.spamhaus.org
• dyna.spamrats.com: dyna.spamrats.com
• xbl.spamhaus.org: xbl.spamhaus.org
• timestamp: Devuelve fecha y hora de la consulta en formato UNIX.
• id: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Positiva:

{"state":"1","dnsbl-1.uceprotect.net":"ok","dnsbl-2.uceprotect.net":"ok","dnsbl-3.uceprotect.net":"ok","dnsbl.dronebl.org":"ok","dnsbl.sorbs.net":"ok","zen.spamhaus.org":"ok","bl.spamcop.net":"ok","list.dsbl.org":"ok","sbl.spamhaus.org":"ok","dyna.spamrats.com":"ok","xbl.spamhaus.org":"ok","timestamp":"1619534182","id":"0"}

{"state":"2","dnsbl-1.uceprotect.net":"ok","dnsbl-2.uceprotect.net":"listed.","dnsbl-3.uceprotect.net":"listed.","dnsbl.dronebl.org":"ok","dnsbl.sorbs.net":"listed.","zen.spamhaus.org":"ok","bl.spamcop.net":"ok","list.dsbl.org":"ok","sbl.spamhaus.org":"ok","dyna.spamrats.com":"ok","xbl.spamhaus.org":"ok","timestamp":"1619533811","id":"0"}

Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test

Definición Técnica de la API: