Exporter des attributs personnalisés

Utilisez cet endpoint pour exporter une liste d’attributs personnalisés enregistrés pour votre appli. Les attributs sont renvoyés par groupes de 50, triés par ordre alphabétique.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation custom_attributes.get.

Limite de débit

We apply a shared rate limit of 1,000 requests per hour to this endpoint. This rate limit is shared with the /events, /events/list, and /purchases/product_list endpoints, as documented in API rate limits.

Paramètres de recherche

Notez que chaque appel à cet endpoint renverra 50 attributs. Pour plus de 50 attributs, utilisez l’en-tête Link pour récupérer les données sur la page suivante, comme le montre l’exemple de réponse suivant.

Exemple de requêtes

Sans curseur

1
2
3
curl --location --request GET 'https://rest.iad-01.braze.com/custom_attributes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Avec curseur

1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/custom_attributes?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Réponse

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
    "message": (required, string) the status of the export, returns 'success' when completed without errors,
    "attributes" : [
        {
            "array_length": 100, (number) the maximum array length, or null if not applicable,
            "data_type": "Number", (string) the data type,
            "description": "The attribute description", (string) the attribute description,
            "name": "The attribute name", (string) the attribute name,
            "status": "Active", (string) the attribute status,
            "tag_names": ["Tag One", "Tag Two"] (array) the tag names associated with the attribute formatted as strings,
        },
        ...
    ]
}

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 section Erreurs fatales.