Zum Inhalt springen

Objekt-Beziehungstypen auflisten

get

/data_objects/types/{type_name}/object_relationship_types

Verwenden Sie diesen Endpunkt, um die verfügbaren Beziehungsarten für Objekt-zu-Objekt-Verknüpfungen für eine bestimmte Ankerrichtung aufzulisten.

Voraussetzungen

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

Rate-Limits

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

Pfadparameter

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

Parameter Erforderlich Datentyp Beschreibung
type_name Erforderlich String Maschinenname des Datenobjekttyps

Abfrageparameter

Die folgende Tabelle listet und beschreibt die Abfrageparameter für den Endpunkt /data_objects/types/{type_name}/object_relationship_types.

Parameter Erforderlich Datentyp Beschreibung
anchor Optional String source (Standard) oder target
limit Optional Integer Seitengröße. Standard 100. Begrenzt auf 1 bis 250
offset Optional Integer Offset. Standard 0. Negative Werte werden auf 0 gesetzt

Beispielanfrage

Dieser Abschnitt enthält ein Beispiel für die Anfrageparameter und eine cURL-Beispielanfrage.

Beispiel für Anfrageparameter

Verwenden Sie dieses JSON-Objekt als Referenz für Anfrageparameter.

{
  "type_name": "account",
  "anchor": "source",
  "limit": 10,
  "offset": 0
}

cURL-Beispielanfrage

Dieses Beispiel listet die verfügbaren Objekt-Beziehungsarten für den Typ account auf, wenn account die Quelle der Beziehung ist.

curl --location --request GET 'https://rest.iad-01.braze.com/data_objects/types/account/object_relationship_types?anchor=source&limit=10&offset=0' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Antwort

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

Beispiel für eine erfolgreiche Antwort

Der Statuscode 200 kann den folgenden Antwortkörper zurückgeben.

{
  "items": [
    {
      "from_type_name": "account",
      "to_type_name": "account",
      "rel_kind": "subaccount",
      "display_name": "subaccount",
      "related_type_name": "account"
    }
  ],
  "total_count": 1,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "limit": 10
}

related_type_name ist der Typ auf der anderen Seite der Beziehung für den ausgewählten anchor.

Antwortparameter

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

Parameter Erforderlich Datentyp Beschreibung
items Erforderlich Array Liste der verfügbaren Objekt-Beziehungstypen
items[].from_type_name Erforderlich String Name des Quell-Datenobjekttyps
items[].to_type_name Erforderlich String Name des Ziel-Datenobjekttyps
items[].rel_kind Erforderlich String Wert der Beziehungsart
items[].display_name Erforderlich String Anzeigename der Beziehungsart
items[].related_type_name Erforderlich String Typ auf der gegenüberliegenden Seite für den angeforderten anchor
total_count Erforderlich Integer Gesamtanzahl der übereinstimmenden Datensätze
has_more Erforderlich Boolean Ob eine weitere Ergebnisseite verfügbar ist
next_offset Optional Integer Offset für die nächste Seite, wenn has_more den Wert true hat
offset Erforderlich Integer Aktueller Seiten-Offset
limit Erforderlich Integer Von der Anfrage verwendete Seitengröße

Fehler

Die folgende Tabelle listet häufige Fehler für diesen Endpunkt und deren Behebung auf.

Status Ursache Empfehlung
400 Ungültiger anchor Verwenden Sie source oder target für anchor.
404 Typ nicht gefunden (data-object-type-not-found) Überprüfen Sie, ob type_name im Workspace existiert und exakt mit dem Maschinennamen übereinstimmt.
401 Fehlender oder ungültiger REST-API-Schlüssel Überprüfen Sie, ob der Authorization-Header Bearer YOUR_REST_API_KEY verwendet und der Schlüssel aktiv ist.
403 API-Schlüssel hat keine Berechtigung oder die Anfrage wird durch die Allowlist blockiert Überprüfen Sie, ob der Schlüssel die Berechtigung data_objects.read hat und ob Ihre Quell-IP auf der Schlüssel-Allowlist steht, falls konfiguriert.
429 Rate-Limit überschritten Wiederholen Sie die Anfrage nach X-RateLimit-Reset und reduzieren Sie die Anfragehäufigkeit.
New Stuff!