Datenobjekt erstellen

Verwenden Sie diesen Endpunkt, um ein Datenobjekt für einen Typ zu erstellen.

Wichtig

Data Objects ist allgemein verfügbar, Ihr Workspace muss jedoch für Accounts bereitgestellt sein, bevor Sie diesen Endpunkt verwenden können. Um die Bereitstellung anzufordern, gehen Sie zu Dateneinstellungen > Accounts und füllen Sie den Fragebogen aus. Weitere Informationen finden Sie unter Accounts aktivieren.

Voraussetzungen

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

Rate-Limit

Dieser Endpunkt gehört zum Data-Objects-Schreib-Bucket mit einem Standardlimit von 1000 Anfragen pro Minute.

Pfadparameter

Die folgende Tabelle listet und beschreibt die Pfadparameter für den Endpunkt /data_objects/objects/{type_name}.

Anfrageparameter

Die folgende Tabelle listet und beschreibt die Parameter im JSON-Anfragebody für den Endpunkt /data_objects/objects/{type_name}.

Beispielanfrage

Dieser Abschnitt enthält eine JSON-Beispiel-Payload und eine cURL-Beispielanfrage.

Beispiel-Payload der Anfrage

1
2
3
4
5
6
7

{
  "object_id": "acct-new",
  "attributes": {
    "name": "New Account",
    "industry": "software"
  }
}

cURL-Beispielanfrage

Dieses Beispiel erstellt einen account-Datensatz mit dem Bezeichner acct-new und setzt dessen Attribute name und industry.

1
2
3
4
5
6
7
8
9
10

curl --location --request POST 'https://rest.iad-01.braze.com/data_objects/objects/account' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "object_id": "acct-new",
  "attributes": {
    "name": "New Account",
    "industry": "software"
  }
}'

Antwort

Dieser Abschnitt enthält ein Beispiel für eine erfolgreiche Antwort und die Antwortfelder.

Beispiel für eine erfolgreiche Antwort

Der Statuscode 201 könnte den folgenden Antwortbody zurückgeben.

1
2
3
4
5
6
7

{
  "data_object": {
    "type_name": "account",
    "object_id": "acct-new",
    "attributes": { "name": "New Account", "industry": "software" }
  }
}

Antwortparameter

Die folgende Tabelle listet und beschreibt die Felder einer erfolgreichen Antwort.

Fehler

Die folgende Tabelle listet häufige Fehler für diesen Endpunkt auf und beschreibt, wie Sie diese beheben können.