Mover ativos do DAM em massa

Move vários ativos do DAM para uma pasta de forma atômica.

Antes de chamar este endpoint, obtenha os IDs dos ativos existentes no mesmo Workspace da Auth Key usada na requisição.

Para arquivos armazenados com /transloadit/store, obtenha o Assembly Status deles e aguarde ASSEMBLY_COMPLETED. Nos arrays results[stepName] retornados, guarde o workspace, o asset_id, o version_id e o path retornado de cada arquivo armazenado. O id comum do arquivo não é seu ID de ativo de armazenamento. Use asset_id para ASSET_ID ou params.asset_ids nos exemplos abaixo.

Use asset_id para acompanhar um ativo em movimentações e renomeações nativas. Adicione version_id ao importar para selecionar os mesmos bytes retidos após uma sobrescrita. Um caminho salvo é uma localização mutável, não uma referência imutável. As regras de acesso e retenção de versões continuam se aplicando.

Para um destino que não seja a raiz, você já deve conhecer o ID da pasta existente no mesmo Workspace. Uma resposta de movimentação ou renomeação salva anteriormente pode fornecer esse ID: folder_id de uma resposta para um único ativo ou assets[].folder_id de uma resposta de movimentação em massa. Essas respostas descrevem a pasta após essa operação; elas não são uma API de descoberta de pastas.

Se você conhece os caminhos em vez dos IDs das pastas, use Mover um arquivo ou pasta de armazenamento. A pasta pai de destino já deve existir. Para mover um ativo para a raiz com este endpoint baseado em IDs, use destination_folder_id: null.

Envie os IDs dos ativos e a pasta de destino juntos dentro de params. O exemplo de requisição abaixo move dois ativos para a raiz com um token bearer.

Substitua os IDs de exemplo pelos IDs dos seus ativos; cada ID deve aparecer apenas uma vez. Ao contrário da renomeação de um único ativo, a movimentação em massa exige um destino explícito. Se algum ativo selecionado não puder ser movido, toda a operação falhará.

Exemplo de requisição

Execute esta requisição em um shell no servidor com curl e um token bearer adequado em TRANSLOADIT_TOKEN. Se precisar de um token, expanda as instruções de configuração abaixo.

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 aceita params assinados ou um token bearer. Consulte Autenticação para instruções de configuração.

Escopo necessário para a Auth Key ou o token bearer: dam:write.

Requisições assinadas exigem tanto uma signature quanto um timestamp params.auth.expires no futuro. Tokens Bearer não exigem nenhum dos dois.

Tipo de conteúdo: application/x-www-form-urlencoded

Os campos de autenticação desta lista se aplicam a requisições assinadas. Com um bearer token, você pode omitir params.auth e o campo signature separado. Compare os parâmetros de requisição específicos de autenticação abaixo.