Skip to content

Lister les Content Blocks disponibles

get

/content_blocks/list

Utilisez cet endpoint pour lister les informations relatives à vos Content Blocks existants.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation content_blocks.list.

Limite de débit

La limite de débit par défaut de Braze de 250 000 requêtes par heure s’applique à cet endpoint, comme documenté dans Limites de débit de l’API.

Paramètres de requête

Paramètre Requis Type de données Description
modified_after Facultatif Chaîne de caractères au format ISO-8601 Récupérer uniquement les Content Blocks mis à jour à partir de la date et de l’heure indiquées.
modified_before Facultatif Chaîne de caractères au format ISO-8601 Récupérer uniquement les Content Blocks mis à jour au plus tard à la date et à l’heure indiquées.
limit Facultatif Nombre positif Nombre maximum de Content Blocks à récupérer. Par défaut à 100 si non renseigné, avec une valeur maximale acceptable de 1 000.
offset Facultatif Nombre positif Nombre de Content Blocks à ignorer avant de renvoyer le reste des modèles correspondant aux critères de recherche.

Exemple de requête

1
2
curl --location --request GET 'https://rest.iad-01.braze.com/content_blocks/list?modified_after=2020-01-01T01:01:01.000000&modified_before=2020-02-01T01:01:01.000000&limit=100&offset=1' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE'

Réponse

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "count": "integer",
  "content_blocks": [
    {
      "content_block_id": (string) the Content Block identifier,
      "name": (string) the name of the Content Block,
      "content_type": (string) the content type, html or text,
      "liquid_tag": (string) the Liquid tags,
      "inclusion_count" : (integer) the inclusion count,
      "created_at": (string) The time the Content Block was created in ISO 8601,
      "last_edited": (string) The time the Content Block was last edited in ISO 8601,
      "tags": (array) An array of tags formatted as strings
    }
  ]
}

Résolution des problèmes

Le tableau suivant répertorie les erreurs possibles et les étapes de résolution associées.

Erreur Résolution des problèmes
Modified after time is invalid La date fournie n’est pas une date valide ou analysable. Reformatez cette valeur en tant que chaîne de caractères au format ISO 8601 (yyyy-mm-ddThh:mm:ss.ffffff).
Modified before time is invalid La date fournie n’est pas une date valide ou analysable. Reformatez cette valeur en tant que chaîne de caractères au format ISO 8601 (yyyy-mm-ddThh:mm:ss.ffffff).
Modified after time must be earlier than or the same as modified before time. Modifiez la valeur modified_after pour qu’elle soit antérieure à la valeur modified_before.
Content Block number limit is invalid Le paramètre limit doit être un entier (nombre positif) supérieur à 0.
Content Block number limit must be greater than 0 Modifiez le paramètre limit pour qu’il soit un entier supérieur à 0.
Content Block number limit exceeds maximum of 1000 Modifiez le paramètre limit pour qu’il soit un entier inférieur à 1 000.
Offset is invalid Le paramètre offset doit être un entier supérieur à 0.
Offset must be greater than 0 Modifiez le paramètre offset pour qu’il soit un entier supérieur à 0.
New Stuff!