Consultar correos electrónicos de rebote duro

Utiliza este punto de conexión para obtener una lista de direcciones de correo electrónico que han tenido un “rebote duro” en tus mensajes de correo electrónico dentro de un periodo de tiempo determinado.

Requisitos previos

Para utilizar este punto de conexión, necesitarás una clave de API con el permiso email.hard_bounces.

Límite de velocidad

Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto de conexión, como se documenta en Límites de velocidad de la API.

Parámetros de la solicitud

Importante

Debes proporcionar un end_date, y un email o un start_date. Si proporcionas los tres, start_date, end_date y un email, damos prioridad a los correos electrónicos proporcionados y no tenemos en cuenta el intervalo de fechas.

Si tu intervalo de fechas tiene más del número limit de rebotes duros, tendrás que hacer varias llamadas a la API, aumentando cada vez el offset hasta que una llamada devuelva menos de limit o cero resultados. Incluir los parámetros offset y limit con email puede devolver una respuesta vacía.

Ejemplo de solicitud

1
2
curl --location --request GET 'https://rest.iad-01.braze.com/email/hard_bounces?start_date=2019-01-01&end_date=2019-02-01&limit=100&offset=1' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE'

Respuesta

Las entradas aparecen en orden descendente.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "emails": [
    {
      "email": (string) an email that has hard bounced,
      "hard_bounced_at": (string) the time the email hard bounced in ISO 8601
    },
    {
      "email": (string) an email that has hard bounced,
      "hard_bounced_at": (string) the time the email hard bounced in ISO 8601
    },
    {
      "email": (string) an email that has hard bounced,
      "hard_bounced_at": (string) the time the email hard bounced in ISO 8601
    }
  ],
  "message": "success"
}