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 o registro mx.

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
Bloquear

Aviso importante
Cuanto más específica sea la regla, mayor será su prioridad de coincidencia.
correo electrónico > dominio > 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 o registros mx específicos. 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.

URL: https://api.zerobounce.net/v2/filters/add
Método: POST
Tipo de contenido: application/x-www-form-urlencoded

  • 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 o mx. (Requerido)
  • value
    La dirección de correo electrónico, el dominio de correo electrónico o el registro mx que desea filtrar, según el objetivo seleccionado. (Requerido)
Respuesta exitosa
Respuesta fallida
Respuesta de error

Después de recibir una respuesta exitosa, su filtro personalizado permitirá o bloqueará automáticamente cualquier correo electrónico, dominio o mx 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 o mx 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 o mx, 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: https://api.zerobounce.net/v2/filters/delete
Método: POST
Tipo de contenido: application/x-www-form-urlencoded

  • 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 o mx. (Requerido)
  • value
    La dirección de correo electrónico, el dominio de correo electrónico o el registro mx que desea filtrar, según el objetivo seleccionado. (Requerido)
Respuesta exitosa
Respuesta fallida
Respuesta de error

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: https://api.zerobounce.net/v2/filters/list
Método: GET

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

RESPUESTA DE PUNTO FINAL

Respuesta exitosa
Respuesta de error

Ejemplos de código