Mover activos DAM en bloque

Mueve varios activos DAM a una carpeta de forma atómica.

Antes de llamar a este endpoint, obtén los IDs de los activos existentes en el mismo Workspace que la Auth Key utilizada para la solicitud.

Para los archivos almacenados con /transloadit/store, consulta su Assembly Status y espera a que alcancen ASSEMBLY_COMPLETED. En los arrays results[stepName] devueltos, conserva los valores workspace, asset_id y version_id, así como el valor path devuelto, de cada archivo almacenado. El id habitual del archivo no es su ID de activo de Storage. Usa asset_id para ASSET_ID o params.asset_ids en los ejemplos siguientes.

Usa asset_id para seguir un activo a través de movimientos y cambios de nombre nativos. Añade version_id al importar para seleccionar los mismos bytes conservados tras una sobrescritura. Una ruta guardada es una ubicación mutable, no una referencia inmutable. El acceso y la retención de versiones siguen siendo aplicables.

Para un destino que no sea la raíz, debes conocer de antemano el ID de la carpeta existente en el mismo Workspace. Una respuesta de movimiento o cambio de nombre guardada previamente puede proporcionar este ID: folder_id de una respuesta para un solo activo o assets[].folder_id de una respuesta de movimiento masivo. Estas respuestas describen la carpeta después de esa operación; no son una API para descubrir carpetas.

Si conoces las rutas en lugar de los IDs de las carpetas, usa Mover un archivo o una carpeta de Storage. La carpeta padre de destino debe existir de antemano. Para mover un activo a la raíz con este endpoint basado en IDs, usa destination_folder_id: null.

Envía los IDs de los activos y la carpeta de destino juntos dentro de params. El ejemplo de solicitud siguiente mueve dos activos a la raíz con un token Bearer.

Sustituye los IDs del ejemplo por los IDs de tus activos; cada ID debe aparecer solo una vez. A diferencia del cambio de nombre de un solo activo, el movimiento masivo requiere un destino explícito. Si alguno de los activos seleccionados no se puede mover, falla toda la operación.

Ejemplo de solicitud

Ejecuta esta solicitud en una shell del lado del servidor con curl y un token Bearer adecuado en TRANSLOADIT_TOKEN. Si necesitas un token, despliega la configuración siguiente.

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}'

Este endpoint acepta params firmados o un token Bearer. Consulta Autenticación para ver las instrucciones de configuración.

Ámbito requerido para el Auth Key o el token de portador: dam:write.

Las solicitudes firmadas requieren tanto una signature como una marca de tiempo futura en params.auth.expires. Los tokens Bearer no requieren ninguno de estos dos elementos.

Tipo de contenido: application/x-www-form-urlencoded

Los campos de autenticación de esta lista se aplican a las solicitudes firmadas. Con un token Bearer puedes omitir params.auth y el campo separado signature. Compara a continuación los parámetros de solicitud de cada método de autenticación.