Mehrere DAM-Assets verschieben

Verschiebt mehrere DAM-Assets atomar in einen Ordner.

Bevor Sie diesen Endpunkt aufrufen, ermitteln Sie die IDs vorhandener Assets im selben Workspace 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. Übernehmen Sie aus den zurückgegebenen results[stepName]-Arrays die asset_id jeder gespeicherten Datei, nicht deren gewöhnliche Datei-id. Verwenden Sie diese Werte für ASSET_ID oder params.asset_ids in den folgenden Beispielen.

Für ein Ziel, das nicht der Stammordner ist, 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 Ermittlung von Ordnern.

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

Senden Sie die Asset-IDs und den Zielordner gemeinsam innerhalb von params. Das folgende Anfragebeispiel verschiebt zwei Assets mit einem Bearer-Token in den Stammordner.

Ersetzen Sie die Beispiel-IDs durch Ihre Asset-IDs; jede ID darf nur einmal vorkommen. Im Gegensatz zur Umbenennung eines einzelnen Assets erfordert eine Massenverschiebung ein ausdrücklich angegebenes Ziel. Wenn eines der ausgewählten Assets nicht verschoben werden kann, schlägt der gesamte Vorgang fehl.

Anfragebeispiel

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 Einrichtungsanleitung 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 POST \
  --url "https://api2.transloadit.com/dam/assets/bulk/move" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"asset_ids":["AAAAAAAAAAAAAAAAAAAAAA","AAAAAAAAAAAAAAAAAAAAAQ"],"destination_folder_id":null}'

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.