Skip to content

Angepasste Attribute exportieren

get

/custom_attributes

Verwenden Sie diesen Endpunkt, um eine Liste der angepassten Attribute zu exportieren, die für Ihre App erfasst wurden. Die Attribute werden in Gruppen von 50, alphabetisch sortiert, zurückgegeben.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung custom_attributes.get.

Rate-Limit

Wir wenden auf diesen Endpunkt ein gemeinsames Rate-Limit von 1.000 Anfragen pro Stunde an. Dieses Rate-Limit wird mit den Endpunkten /events, /events/list und /purchases/product_list geteilt, wie in API-Rate-Limits dokumentiert.

Abfrageparameter

Beachten Sie, dass jeder Aufruf dieses Endpunkts 50 Attribute zurückgibt. Bei mehr als 50 Attributen verwenden Sie den Link-Header, um die Daten auf der nächsten Seite abzurufen, wie in der folgenden Beispielantwort gezeigt.

Parameter Erforderlich Datentyp Beschreibung
cursor Optional String Bestimmt die Paginierung der angepassten Attribute.

Beispielanfragen

Ohne Cursor

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'

Mit Cursor

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'

Antwort

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
    "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,
        },
        ...
    ]
}

Antwortcodes bei schwerwiegenden Fehlern

Statuscodes und zugehörige Fehlermeldungen, die zurückgegeben werden, wenn Ihre Anfrage auf einen schwerwiegenden Fehler stößt, finden Sie unter Schwerwiegende Fehler.
New Stuff!