Exporter la liste des événements personnalisés
/events/list
Utilisez cet endpoint pour exporter une liste d’événements personnalisés qui ont été enregistrés pour votre application. Les noms des événements sont renvoyés par groupes de 250, triés par ordre alphabétique.
Conditions préalables
Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation events.list.
Limite de débit
Nous appliquons une limite de débit partagée de 1 000 requêtes par heure à cet endpoint. Cette limite de débit est partagée avec les endpoints /custom_attributes, /events et /purchases/product_list, comme documenté dans Limites de débit de l’API.
Paramètres de requête
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
page |
Facultatif | Entier | La page des noms d’événements à renvoyer, par défaut 0 (renvoie le premier ensemble pouvant contenir jusqu’à 250 éléments). |
Exemple de requête
1
2
curl --location --request GET 'https://rest.iad-01.braze.com/events/list?page=3' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Réponse
1
2
3
4
5
6
7
8
9
{
"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,
...
]
}
Codes de réponse des erreurs fatales
Pour connaître les codes d’état et les messages d’erreur associés qui seront renvoyés si votre requête rencontre une erreur fatale, reportez-vous à la rubrique Erreurs fatales et réponses.
Pour obtenir de l’aide sur les exportations CSV et API, consultez la section Résolution des problèmes d’exportation.