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

Nous appliquons à cet endpoint une limite de débit partagée de 1 000 requêtes par heure. Cette limitation du débit est partagée avec les endpoints /events, /events/list et /purchases/product_list, comme documenté dans Limites de débit de l’API.

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.