Zum Inhalt springen

Verfügbare Content Blocks auflisten

get

/content_blocks/list

Verwenden Sie diesen Endpunkt, um Informationen zu Ihren vorhandenen Content Blocks aufzulisten.

Voraussetzungen

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

Rate-Limit

Wir wenden auf diesen Endpunkt das standardmäßige Braze-Rate-Limit von 250.000 Anfragen pro Stunde an, wie in API-Rate-Limits dokumentiert.

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
modified_after Optional String im ISO-8601-Format Ruft nur Content Blocks ab, die zum oder nach dem angegebenen Zeitpunkt aktualisiert wurden.
modified_before Optional String im ISO-8601-Format Ruft nur Content Blocks ab, die zum oder vor dem angegebenen Zeitpunkt aktualisiert wurden.
limit Optional Positive Zahl Maximale Anzahl der abzurufenden Content Blocks. Standardmäßig 100, wenn nicht angegeben, mit einem maximal zulässigen Wert von 1000.
offset Optional Positive Zahl Anzahl der Content Blocks, die übersprungen werden sollen, bevor der Rest der Templates zurückgegeben wird, die den Suchkriterien entsprechen.

Beispielanfrage

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'

Antwort

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

Fehlerbehebung

In der folgenden Tabelle finden Sie eine Liste möglicher zurückgegebener Fehler und die entsprechenden Schritte zur Fehlerbehebung.

Fehler Fehlerbehebung
Modified after time is invalid Das angegebene Datum ist kein gültiges oder analysierbares Datum. Formatieren Sie diesen Wert als String im ISO-8601-Format (yyyy-mm-ddThh:mm:ss.ffffff).
Modified before time is invalid Das angegebene Datum ist kein gültiges oder analysierbares Datum. Formatieren Sie diesen Wert als String im ISO-8601-Format (yyyy-mm-ddThh:mm:ss.ffffff).
Modified after time must be earlier than or the same as modified before time. Ändern Sie den Wert modified_after auf einen Zeitpunkt, der vor dem Wert von modified_before liegt.
Content Block number limit is invalid Der Parameter limit muss eine Ganzzahl (positive Zahl) größer als 0 sein.
Content Block number limit must be greater than 0 Ändern Sie den Parameter limit in eine Ganzzahl größer als 0.
Content Block number limit exceeds maximum of 1000 Ändern Sie den Parameter limit in eine Ganzzahl kleiner als 1000.
Offset is invalid Der Parameter offset muss eine Ganzzahl größer als 0 sein.
Offset must be greater than 0 Ändern Sie den Parameter offset in eine Ganzzahl größer als 0.
New Stuff!