Mover o renombrar un activo DAM

Mueve o renombra un activo DAM sin modificar su objeto almacenado.

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

Para los archivos almacenados con /transloadit/store, recupera su Assembly Status y espera a que se alcance ASSEMBLY_COMPLETED. En los arrays results[stepName] devueltos, conserva el asset_id de cada archivo almacenado, no su id de archivo habitual. Usa estos valores para ASSET_ID o params.asset_ids en los ejemplos siguientes.

Si el destino no es la raíz, debes conocer de antemano el ID de la carpeta existente en el mismo Workspace. Una respuesta guardada previamente de una operación de movimiento o cambio de nombre puede proporcionarte este ID: folder_id de una respuesta para un único recurso 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.

Actualmente no hay ningún endpoint público que permita buscar el ID de una carpeta DAM a partir de su ruta. Si aún no tienes el ID de la carpeta de destino, contacta con soporte antes de intentar mover el recurso a un destino que no sea la raíz. Para moverlo a la raíz, usa destination_folder_id: null.

Incluye al menos uno de los parámetros filename o destination_folder_id dentro de params. El nombre de archivo debe ser un nombre sin una ruta de carpeta.

Para cambiar el nombre de un recurso en su carpeta actual, envía solo filename dentro de params, como en el ejemplo de solicitud siguiente.

Para mover el recurso a la raíz en su lugar, incluye explícitamente destination_folder_id: null:

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

Para otra carpeta, sustituye null por el ID de esa carpeta. Omitir el parámetro y usar null son operaciones diferentes.

Límites de la ruta del recurso

La ruta de destino completa (carpetas más nombre de archivo) no debe superar los 512 puntos de código Unicode ni los 1024 bytes UTF-8 después de la normalización. Un nombre de archivo que por sí solo respete estos límites puede superarlos en una carpeta anidada.

Ejemplo de solicitud

Asigna a ASSET_ID el valor de tu recurso sin aplicarle codificación porcentual.

Ejecuta esta solicitud en un 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 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"}'

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.