Skip to content

Content-Block erstellen

post

/content_blocks/create

Verwenden Sie diesen Endpunkt, um einen Content-Block zu erstellen.

See me in Postman

Voraussetzungen

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

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.

Anfragetext

1
2

Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
4
5
6
7

{
  "name": (required, string) Must be less than 100 characters,
  "description": (optional, string) The description of the Content Block. Must be less than 250 character,
  "content": (required, string) HTML or text content within Content Block,
  "state": (optional, string) Choose `active` or `draft`. Defaults to `active` if not specified,
  "tags": (optional, array of strings) Tags must already exist
}

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
name Erforderlich String Name des Content-Blocks. Muss weniger als 100 Zeichen umfassen.
description Optional String Beschreibung des Content-Blocks. Muss weniger als 250 Zeichen umfassen.
content Erforderlich String HTML- oder Textinhalt innerhalb des Content-Blocks.
state Optional String Wählen Sie active oder draft. Der Standardwert ist active, wenn nichts angegeben wird.
tags Optional String-Array Tags müssen bereits existieren.

Beispielanfrage

1
2
3
4
5
6
7
8
9
10

curl --location --request POST 'https://rest.iad-01.braze.com/content_blocks/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "name": "content_block",
  "description": "This is my Content Block",
  "content": "HTML content within block",
  "state": "draft",
  "tags": ["marketing"]
}'

Antwort

1
2
3
4
5
6

{
  "content_block_id": (string) Your newly generated block id,
  "liquid_tag": (string) The generated block tag from the Content Block name,
  "created_at": (string) The time the Content Block was created in ISO 8601,
  "message": "success"
}

Fehlerbehebung

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

Fehler Fehlerbehebung  
Content cannot be blank    
Content must be a string Achten Sie darauf, dass Ihr Inhalt in Anführungszeichen ("") eingeschlossen ist.  
Content must be smaller than 50kb Der Inhalt Ihres Content-Blocks muss insgesamt weniger als 50 KB groß sein.  
Content contains malformed liquid Das angegebene Liquid ist ungültig oder nicht parsbar. Bitte versuchen Sie es erneut mit gültigem Liquid oder wenden Sie sich an den Support.  
Content Block cannot be referenced within itself    
Content Block description cannot be blank    
Content Block description must be a string Achten Sie darauf, dass die Beschreibung Ihres Content-Blocks in Anführungszeichen ("") eingeschlossen ist.  
Content Block description must be shorter than 250 characters    
Content Block name cannot be blank    
Content Block name must be shorter than 100 characters    
Content Block name can only contain alphanumeric characters Content-Block-Namen können jedes der folgenden Zeichen enthalten: die Buchstaben (groß- oder kleingeschrieben) A bis Z, die Zahlen 0 bis 9, Bindestriche - und Unterstriche _. Sie können keine nicht-alphanumerischen Zeichen wie Emojis, !, @, ~, & und andere „Sonderzeichen“ enthalten.  
Content Block with this name already exists Versuchen Sie einen anderen Namen.  
Content Block state must be either active or draft    
Tags must be an array Tags müssen als String-Array formatiert werden, zum Beispiel ["marketing", "promotional", "transactional"].  
All tags must be strings Achten Sie darauf, dass Ihre Tags in Anführungszeichen ("") eingeschlossen sind.  
Some tags could not be found Um bei der Erstellung eines Content-Blocks ein Tag hinzuzufügen, muss das Tag bereits in Braze vorhanden sein.  
New Stuff!