Lister les types d’objets de données

Utilisez cet endpoint pour lister les types d’objets de données dans un espace de travail.

Important

Les objets de données sont actuellement en accès anticipé. Votre espace de travail doit être activé avant que les permissions de clé API pour les objets de données n’apparaissent dans Paramètres > Clés API.

Prérequis

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec la permission data_objects.read.

Limite de débit

Cet endpoint se trouve dans le compartiment de lecture des objets de données avec une limite par défaut de 50 requêtes par minute.

Paramètres de requête

Le tableau suivant liste et décrit les paramètres de requête pour l’endpoint /data_objects/types.

Exemple de requête

Cette section comprend un exemple de payload de paramètres de requête et un exemple de requête cURL.

Exemple de payload de requête

Utilisez cet objet JSON comme référence pour les paramètres de requête de cette requête.

1
2
3
4
5

{
  "search_term": "acc",
  "limit": 2,
  "offset": 0
}

Exemple de requête cURL

Cet exemple liste les types d’objets de données correspondant au terme de recherche acc, en renvoyant deux résultats par page.

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/data_objects/types?search_term=acc&limit=2&offset=0' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Réponse

Cette section comprend un exemple de réponse réussie et les champs de la réponse.

Exemple de réponse réussie

Le code de statut 200 peut renvoyer le corps de réponse suivant.

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

{
  "items": [
    {
      "type_name": "account",
      "metadata": { "display_name_source": "name" }
    },
    {
      "type_name": "contact",
      "metadata": {}
    }
  ],
  "total_count": 2,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "limit": 100
}

metadata.display_name_source est présent lorsqu’un champ de nom d’affichage est configuré pour le type.

Paramètres de réponse

Le tableau suivant liste et décrit les champs d’une réponse réussie.

Erreurs

Le tableau suivant liste les erreurs courantes pour cet endpoint et comment les résoudre.