Reglas de filtro personalizadas para lista blanca y lista negra

La API de validación de correo electrónico de ZeroBounce ofrece la posibilidad de utilizar reglas de filtro personalizadas para crear listas blancas y negras personalizadas. Se pueden colocar en el nivel de correo electrónico, dominio, registro mx o TLD (Dominio de Nivel Superior).

Comenzar

El proceso de validación verifica si hay un registro coincidente en su lista de reglas de filtrado. Cuando se encuentra uno, el estado y el subestado del correo electrónico que se está validando se establecerán de la siguiente manera:

Permitir

    "status": "valid"
    "sub_status": "allowed"
  
Bloquear

     "status": "do_not_mail"
     "sub_status": "blocked"
  

Aviso importante
Cuanto más específica sea la regla, mayor será su prioridad de coincidencia.
correo electrónico > dominio > tld > mx

Por ejemplo:

api_key: su clave de API
rule: block
target: email
value: test@example.com

Anulaciones

api_key: su clave de API
rule: allow
target: domain
value: example.com

Todos los campos son obligatorios.

Agregar o modificar la regla "permitir" o "bloquear"

Esto le permite crear reglas de filtro personalizadas para permitir o bloquear correos electrónicos, dominios de correo electrónico, registros mx específicos o tld. Para este último, también puede usar un asterisco (*) al frente para indicar un comodín para los registros mx.

Bloquee automáticamente remitentes y dominios que no sean de confianza y permita que otras partes confiables comiencen el proceso de validación de correo electrónico.

Para modificar una regla, envíe los mismos campos "objetivo" y "valor", pero cambie la "regla".

A continuación se muestra un ejemplo de código java de cómo agregar una regla usando la API. Debe tener una cuenta de ZeroBounce y acceso a su clave API para agregar una regla de filtro personalizada.

Espere hasta 1 minuto para que se propaguen los cambios.

No hay límites en la cantidad de filtros que puedes configurar para permitir/bloquear.

Cuando validas un correo electrónico de la lista de permitidos/bloqueados, los créditos seguirán siendo deducidos.

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/filters/add
URL de API de U.S.A.*: api-us.zerobounce.net/v2/filters/add
Método: POST
Tipo de contenido: application/x-www-form-urlencoded

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

  • Parámetro
    Descripción
  • api_key
    Su clave API, que se encuentra en su cuenta. (Requerida)
  • rule
    Elija qué acción debe tomar el filtro. Valores posibles: permitir, bloquear. (Requerido)
  • target
    Elija para qué objetivo se establece el filtro. Valores posibles: correo electrónico, dominio, mx o tld. (Requerido)
  • value
    La dirección de correo electrónico, el dominio de correo electrónico, el registro mx o tld que desea filtrar, según el objetivo seleccionado. (Requerido)
Respuesta exitosa

    {"Message": "Filter successfully added"}
    {"Message": "Filter successfully updated"}
  
Respuesta fallida

    {"Message": "Filter already exists"}
Respuesta de error

    {"Error": "Invalid API key or your account ran out of credits"}
    {"Error": "Missing param: api_key"}
    {"Error": "Missing param: rule"}
    {"Error": "Missing param: target"}
    {"Error": "Missing param: value"}
    {"Error": "Allowed values for rule: allow, block"}
    {"Error": "Allowed values for target: email, domain, mx, tld"}
    {"Error": "Bad email syntax for param: value"}
    {"Error": "Bad domain syntax for param: value"}
    {"Error": "Invalid request format"}

Después de recibir una respuesta exitosa, su filtro personalizado permitirá o bloqueará automáticamente cualquier correo electrónico, dominio, mx o tld que coincida con su regla.

Ejemplos de código

Eliminar una regla de filtro personalizada

Esto le permitirá eliminar cualquier regla de permiso o bloqueo existente. Si ya no necesita bloquear un correo electrónico, dominio, mx or tld específico, considere eliminar la regla para permitir que el proceso de validación de correo electrónico continúe normalmente.

Para eliminar cualquier regla de filtro personalizada en el nivel de registro de correo electrónico, dominio, mx o tld, debe ingresar los parámetros de filtro personalizados utilizando el punto final para eliminar una regla de filtro.

A continuación se muestra un ejemplo de cómo eliminar una regla mediante la API. Debe tener una cuenta de ZeroBounce y acceso a su clave API para borrar una regla de filtro personalizada.

Espere hasta 1 minuto para que se propaguen los cambios.

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/filters/delete
URL de API de U.S.A.*: api-us.zerobounce.net/v2/filters/delete
Método: POST
Tipo de contenido: application/x-www-form-urlencoded

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

  • Parámetro
    Descripción
  • api_key
    Su clave API, que se encuentra en su cuenta. (Requerida)
  • rule
    Elija qué acción debe tomar el filtro. Valores posibles: permitir, bloquear. (Requerido)
  • target
    Elija para qué objetivo se establece el filtro. Valores posibles: correo electrónico, dominio, mx o tld. (Requerido)
  • value
    La dirección de correo electrónico, el dominio de correo electrónico, el registro mx o tld que desea filtrar, según el objetivo seleccionado. (Requerido)
Respuesta exitosa

  {"Message": "Filter successfully deleted"}
Respuesta fallida

  {"Message": "Filter does not exist"}
Respuesta de error

    {"Error": "Invalid API key or your account ran out of credits"}
    {"Error": "Missing param: api_key"}
    {"Error": "Missing param: rule"}
    {"Error": "Missing param: target"}
    {"Error": "Missing param: value"}
    {"Error": "Allowed values for rule: allow, block"}
    {"Error": "Allowed values for target: email, domain, mx, tld"}
    {"Error": "Bad email syntax for param: value"}
    {"Error": "Bad domain syntax for param: value"}
    {"Error": "Invalid request format"}

Ejemplos de código

Enumere los resultados de su filtro

Después de implementar sus reglas de filtro personalizadas, la API de validación de correo electrónico las aplicará automáticamente a futuros intentos de validación.

El proceso de validación finaliza si encuentra una regla de "permitir" o "bloquear" coincidente para el correo electrónico que se está validando. Si desea obtener una descripción general de sus filtros y los resultados correspondientes, use el siguiente ejemplo para comenzar.

Esta API le muestra una lista completa de sus reglas personalizadas de permitir o bloquear y todos los objetivos correspondientes que coinciden con su conjunto de reglas.

Si necesita agregar o eliminar nuevas reglas, puede hacerlo en cualquier momento. Sus cambios se aplicarán a futuros intentos de validación de correo electrónico

Si necesita ayuda para implementar o eliminar sus reglas personalizadas de permitir o bloquear, comuníquese con nuestro equipo de soporte. Estamos disponibles las 24 horas, los 7 días de la semana y listos para ayudarlo a preparar sus nuevas listas blancas y negras.

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/filters/list
URL de API de U.S.A.*: api-us.zerobounce.net/v2/filters/add
Método: GET

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

  • Parámetro
    Descripción
  • api_key
    Su clave API, que se encuentra en su cuenta. (Requerida)

RESPUESTA DE PUNTO FINAL

Respuesta exitosa

  [
    {
        "rule": "allow",
        "target": "email",
        "value": "test@example.com"
    },
    {
        "rule": "block",
        "target": "domain",
        "value": "example.com"
    },
    {
        "rule": "allow",
        "target": "mx",
        "value": "long.string.example.com"
    },
    {
        "rule": "allow",
        "target": "mx",
        "value": "*example.com"
    },
    {
        "rule": "allow",
        "target": "tld",
        "value": ".com"
    }
 ]
Respuesta de error

  {"Error": "Invalid API key or your account ran out of credits"}
  {"Error": "Missing param: api_key"}

Ejemplos de código