Exportar lista de eventos personalizados
/events/list
Utiliza este punto final para exportar una lista de eventos personalizados que se han registrado para tu aplicación. Los nombres de los eventos se devuelven en grupos de 250, ordenados alfabéticamente.
Requisitos previos
Para utilizar este punto final, necesitarás una clave de API con el permiso events.list
.
Límite de velocidad
Aplicamos un límite de velocidad compartido de 1.000 peticiones por hora a este punto final. Este límite de velocidad se comparte con los puntos finales /custom_attributes
, /events
, y /purchases/product_list
, como se documenta en Límites de velocidad de la API.
Parámetros de la solicitud
Parámetro | Obligatoria | Tipo de datos | Descripción |
---|---|---|---|
page |
Opcional | Entero | La página de nombres de eventos a devolver, predeterminada a 0 (devuelve el primer conjunto de hasta 250). |
Ejemplo de solicitud
1
2
curl --location --request GET 'https://rest.iad-01.braze.com/events/list?page=3' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
1
2
3
4
5
6
7
8
9
10
11
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
"message": (required, string) the status of the export, returns 'success' when completed without errors,
"events" : [
"Event A", (string) the event name,
"Event B", (string) the event name,
"Event C", (string) the event name,
...
]
}
Códigos de respuesta de error fatal
Para conocer los códigos de estado y los mensajes de error asociados que se devolverán si tu solicitud encuentra un error fatal, consulta Errores fatales y respuestas.
Para obtener ayuda con las exportaciones CSV y API, visita Solución de problemas de exportación.