DAM-Asset verschieben oder umbenennen

Verschiebt ein DAM-Asset oder benennt es um, ohne das gespeicherte Objekt zu verändern.

Bevor Sie diesen Endpunkt aufrufen, ermitteln Sie die IDs vorhandener Assets, die sich im selben Workspace befinden wie der für die Anfrage verwendete Auth Key.

Für Dateien, die mit /transloadit/store gespeichert wurden, rufen Sie deren Assembly Status ab und warten Sie auf ASSEMBLY_COMPLETED. Bewahren Sie aus den zurückgegebenen results[stepName]-Arrays die asset_id jeder gespeicherten Datei auf, nicht deren gewöhnliche Datei-ID id. Verwenden Sie diese Werte für ASSET_ID oder params.asset_ids in den folgenden Beispielen.

Für ein Ziel außerhalb des Stammordners müssen Sie die ID des vorhandenen Ordners im selben Workspace bereits kennen. Eine zuvor gespeicherte Antwort auf eine Verschiebung oder Umbenennung kann diese ID liefern: folder_id aus einer Antwort für ein einzelnes Asset oder assets[].folder_id aus einer Antwort auf eine Massenverschiebung. Diese Antworten beschreiben den Ordner nach dem jeweiligen Vorgang; sie sind keine API zur Ordnersuche.

Derzeit gibt es keinen öffentlichen Endpunkt, um eine DAM-Ordner-ID anhand eines Pfads zu ermitteln. Wenn Sie die ID des Zielordners noch nicht kennen, kontaktieren Sie den Support, bevor Sie versuchen, in einen anderen Ordner als den Stammordner zu verschieben. Zum Verschieben in den Stammordner verwenden Sie destination_folder_id: null.

Geben Sie innerhalb von params mindestens einen der Parameter filename oder destination_folder_id an. Ein Dateiname muss ein Name ohne Ordnerpfad sein.

Um ein Asset in seinem aktuellen Ordner umzubenennen, senden Sie innerhalb von params nur filename, wie im folgenden Anfragebeispiel.

Um das Asset stattdessen in den Stammordner zu verschieben, geben Sie ausdrücklich destination_folder_id: null an:

{ "destination_folder_id": null, "filename": "renamed.jpg" }

Für einen anderen Ordner ersetzen Sie null durch dessen Ordner-ID. Das Weglassen des Parameters und die Angabe von null sind unterschiedliche Vorgänge.

Grenzen für Asset-Pfade

Der vollständige Zielpfad (Ordner plus Dateiname) darf nach der Normalisierung höchstens 512 Unicode-Codepunkte und 1024 UTF-8-Bytes umfassen. Ein Dateiname, der für sich genommen diese Grenzen einhält, kann sie in einem verschachtelten Ordner dennoch überschreiten.

Anfragebeispiel

Setzen Sie ASSET_ID auf den Wert Ihrer Ressource, ohne diesen mit Prozentkodierung zu versehen.

Führen Sie diese Anfrage in einer serverseitigen Shell mit curl und einem geeigneten Bearer-Token in TRANSLOADIT_TOKEN aus. Wenn Sie ein Token benötigen, klappen Sie die folgende Anleitung zur Einrichtung auf.

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=dam:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

curl --fail-with-body -sS --request PATCH \
  --url "https://api2.transloadit.com/dam/assets/${ASSET_ID:?Set ASSET_ID}" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"filename":"renamed.jpg"}'

Dieser Endpunkt akzeptiert signierte params oder ein Bearer-Token. Anweisungen zur Einrichtung finden Sie unter Authentifizierung.

Erforderlicher Berechtigungsumfang für Auth Key oder Bearer-Token: dam:write.

Signierte Anfragen erfordern sowohl eine signature als auch einen in der Zukunft liegenden Zeitstempel für params.auth.expires. Bearer-Tokens erfordern keines von beiden.

Content-Type: application/x-www-form-urlencoded

Die Authentifizierungsfelder in dieser Liste gelten für signierte Anfragen. Mit einem Bearer-Token können Sie params.auth und das separate Feld signature weglassen. Vergleichen Sie unten die Anfrageparameter der einzelnen Authentifizierungsmethoden.