Asset in die Medienbibliothek hochladen

Verwenden Sie diesen Endpunkt, um ein Asset zur Braze-Medienbibliothek hinzuzufügen, entweder über eine extern gehostete URL (asset_url) oder über Binärdaten, die im Anfragetext (asset_file) gesendet werden. Dieser Endpunkt unterstützt Bilder und ZIP-Dateien, die Bilder enthalten.

Tipp

Sie können diesen Endpunkt auch über den Braze-MCP-Server mit der Funktion create_media_library_asset aufrufen. So können KI-Tools wie Claude und Cursor Assets über natürlichsprachliche Eingaben in Ihre Medienbibliothek hochladen.

Voraussetzungen

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

Rate-Limit

Dieser Endpunkt hat ein Rate-Limit von 100 Anfragen pro Stunde, wie in API-Rate-Limits dokumentiert.

Anfragetext

Wenn Sie asset_url angeben, lädt der Endpunkt die Datei von der URL herunter. Wenn Sie asset_file angeben, verwendet der Endpunkt die Binärdaten im Anfragetext.

Beispiel für einen Anfragetext mit asset_url:

1
2
3
4
{
  "asset_url": "https://cdn.example.com/assets/cat.jpg",
  "name": "Cat Graphic"
}

Beispiel für einen Anfragetext mit asset_file:

1
2
3
4
{
  "asset_file": <BINARY FILE DATA>,
  "name": "Cat Graphic"
}

Der Anfragetext enthält die folgenden Parameter:

Wichtig

asset_url und asset_file schließen sich gegenseitig aus. Sie dürfen nur eines davon in Ihre API-Anfrage aufnehmen.

Namen der hochgeladenen Dateien

In diesem Abschnitt wird erläutert, wie der Endpunkt hochgeladenen Dateien Namen zuweist, je nachdem, ob Sie den Parameter name angeben.

Einzelne Datei-Uploads

ZIP-Datei-Uploads

Beispielanfrage

Dieser Abschnitt enthält zwei curl-Beispielanfragen: eine zum Hinzufügen eines Assets über eine URL und eine weitere über Binärdaten.

Diese Anfrage zeigt ein Beispiel für das Hinzufügen eines Assets zur Medienbibliothek mithilfe einer asset_url.

1
2
3
4
curl -X POST --location 'https://rest.iad-01.braze.com/media_library/create' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--header 'Content-Type: application/json' \
--data '{"asset_url": "https://cdn.example.com/assets/cat.jpg", "name": "Cat Graphic"}'

Diese Anfrage zeigt ein Beispiel für das Hinzufügen eines Assets zur Medienbibliothek mithilfe einer asset_file.

1
2
3
4
curl -X POST --location 'https://rest.iad-01.braze.com/media_library/create' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--header 'Content-Type: application/json' \
--data '{"asset_file":<BINARY FILE DATA>, "name":"Cat Graphic"}'

Fehlerantworten

In diesem Abschnitt werden mögliche Fehler sowie die entsprechenden Nachrichten und Beschreibungen aufgeführt.

Validierungsfehler

Validierungsfehler geben eine Struktur wie die folgende zurück:

1
2
3
{
  "message": (String) Human-readable error description
}

Diese Tabelle listet mögliche Validierungsfehler auf.

Verarbeitungsfehler

Verarbeitungsfehler geben eine andere Antwort mit Fehlercodes zurück:

1
2
3
4
5
{
  "message": (String) Human-readable error description,
  "error_code": (String) error code,
  "meta": { }
}

Diese Tabelle listet mögliche Verarbeitungsfehler auf.

Antwort

Für diesen Endpunkt gibt es fünf Statuscode-Antworten: 200, 400, 403, 429 und 500.

Das folgende JSON zeigt die erwartete Struktur der Antwort.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
    "new_assets": [
        {
            "name": (String) the name of the asset,
            "size": (Integer) the byte size of the asset,
            "url": (String) the URL to access the asset,
            "ext": (String) the file extension (e.g., "png", "jpg", "gif")
        }
    ],
    "errors": [
        {
            "name": (String) the name of the asset,
            "size": (Integer) the byte size of the asset,
            "ext": (String) the file extension (e.g., "png", "jpg", "gif"),
            "error": (String) the error that occurred
        }
    ],
    "dashboard_url": (String) the URL to view this asset in the Braze dashboard
}