Transloadit

Listar ativos de armazenamento

Lista páginas de tamanho limitado de ativos do Workspace com identidades estáveis e metadados da versão atual.

GEThttps://api2.transloadit.com/dam/assets

Retorna metadados dos ativos existentes no momento no Workspace autenticado, sem baixar seus bytes.

Passe o valor de next_cursor como cursor, com o mesmo prefixo, para ler a próxima página. Pare quando next_cursor for null. As páginas têm tamanho limitado e não formam um snapshot: movimentações, gravações ou exclusões simultâneas podem alterar as páginas seguintes.

Os IDs de ativos e versões retornados podem ser salvos e usados com /transloadit/import. Use uma barra final no prefixo para delimitar um diretório, como photos/ em vez de photos.

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 a configuração abaixo.

Precisa de um token bearer?

Em um shell confiável no servidor com curl e jq, defina TRANSLOADIT_KEY e TRANSLOADIT_SECRET com sua Auth Key e seu Auth Secret. Mantenha ambas as credenciais e o token resultante em segredo; nunca execute esta configuração em código no navegador.

Primeiro, crie um token com os escopos exigidos por este endpoint. Sua Auth Key já deve conceder esses escopos.

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:read 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

Mantenha este shell aberto e execute a requisição abaixo. Reutilize o token enquanto ele permanecer válido.

curl --fail-with-body -sS --request GET --get \
  --url "https://api2.transloadit.com/dam/assets" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"prefix":"photos/","limit":100}'

Autenticação

Este endpoint aceita params assinados ou um token bearer. Consulte Autenticação para instruções de configuração.

Escopos necessários para a Auth Key ou o token bearer: dam:read, 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.

Parâmetros de consulta

  • params (string JSON). Um objeto codificado em JSON cujas chaves suportadas estão listadas abaixo.

  • signature (string). Obrigatório para requisições assinadas. Omita este campo ao usar um bearer token.

Chaves suportadas dentro do campo params assinado

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.

Esquema JSON completo

Abrir JSON em uma nova aba

params: Somente os campos listados para este objeto são aceitos.

CampoTipo e descrição
params.auth

obrigatório para requisições assinadas; opcional com um bearer token

object

Contém a chave de API da Transloadit e os metadados de Signature Authentication para uma solicitação de metadados de armazenamento.

params.auth: Somente os campos listados para este objeto são aceitos.

params.auth.expires

obrigatório

string

Timestamp de expiração no formato ISO 8601 situado no futuro. Obrigatório quando uma requisição é assinada ou exige autenticação por assinatura; requisições autenticadas por bearer podem omiti-lo.

params.auth.key

obrigatório

string

Chave de API da Transloadit usada para autenticar as requisições

params.auth.nonce
string | integer

Valor único e aleatório incluído nos parâmetros da requisição assinada para tornar cada assinatura única e evitar a reutilização acidental de assinaturas.

params.cursor
string (comprimento mínimo: 1, comprimento máximo: 512)

Valor opaco de continuação de next_cursor na resposta anterior. Mantenha o mesmo prefixo durante a paginação. Omita na primeira página.

params.limit
integer (padrão: 100, mínimo: 1, máximo: 500)

Número máximo de ativos por página. O padrão é 100 e aceita até 500; siga next_cursor até que seja null.

params.prefix
string (padrão: "", comprimento máximo: 512)

Listar apenas os caminhos atuais dos ativos que comecem com este prefixo, diferenciando maiúsculas de minúsculas. O valor padrão vazio inclui todo o Workspace; inclua uma barra no final para selecionar um limite de diretório.

Parâmetros de requisição por método de autenticação

Com parâmetros assinados

Inclua sua Auth Key como params.auth.key. Ao assinar a requisição, inclua um timestamp futuro em params.auth.expires e envie a assinatura no campo separado signature. As definições de campos abaixo usam caminhos dentro de params.

Esquema JSON completo

Abrir JSON em uma nova aba

params: Somente os campos listados para este objeto são aceitos.

Usa as definições de campo acima: params.auth, params.cursor, params.limit, params.prefix

Com um token bearer

Envie o token bearer no cabeçalho Authorization. Você pode omitir params.auth e o campo signature separado. Os demais parâmetros obrigatórios continuam se aplicando. As definições de campos abaixo usam caminhos dentro de params.

Esquema JSON completo

Abrir JSON em uma nova aba

params: Somente os campos listados para este objeto são aceitos.

Usa as definições de campo acima: params.cursor, params.limit, params.prefix

CampoTipo e descrição
params.auth
object

Contém a chave de API da Transloadit e os metadados de Signature Authentication para uma solicitação de metadados de armazenamento.

params.auth: Somente os campos listados para este objeto são aceitos.

params.auth.expires
string

Timestamp de expiração no formato ISO 8601 situado no futuro. Obrigatório quando uma requisição é assinada ou exige autenticação por assinatura; requisições autenticadas por bearer podem omiti-lo.

params.auth.key
string

Chave de API da Transloadit usada para autenticar as requisições

params.auth.nonce
string | integer

Valor único e aleatório incluído nos parâmetros da requisição assinada para tornar cada assinatura única e evitar a reutilização acidental de assinaturas.

Resposta

Veja um exemplo de corpo de resposta:

{
  "assets": [
    {
      "asset_id": "AAAAAAAAAAAAAAAAAAAAAA",
      "height": 600,
      "mime": "image/jpeg",
      "path": "renamed.jpg",
      "size": 12345,
      "version_id": "AAAAAAAAAAAAAAAAAAAAAQ",
      "width": 800,
      "workspace": "example-workspace"
    }
  ],
  "message": "The Storage assets were successfully listed.",
  "next_cursor": null,
  "ok": "DAM_ASSETS_LISTED",
  "workspace": "example-workspace"
}

sucesso 2xx

Corpo da resposta JSON. application/json text/plain; charset=utf-8

Esquema do corpo da resposta
Esquema JSON completo

Abrir JSON em uma nova aba

A resposta contém apenas os campos listados para este objeto.

CampoTipo e descrição
assets

obrigatório

Array<object>
Esquema do item do array
object

assets[]: A resposta pode conter campos adicionais.

CampoTipo e descrição
assets[].asset_id

obrigatório

string

ID estável do ativo. Ele é preservado em movimentações e renomeações nativas; use-o sem uma versão para selecionar os bytes atuais.

Padrão de validação (expressão regular)^[A-Za-z0-9_-]{21}[AQgw]$
assets[].height
integer (mínimo exclusivo: 0, máximo: 9007199254740991)

Altura de exibição em pixels, após aplicar a orientação EXIF, quando conhecida.

assets[].md5hash
string

Soma de verificação MD5 em letras minúsculas dos bytes armazenados, quando disponível.

Padrão de validação (expressão regular)^[a-f0-9]{32}$
assets[].mime

obrigatório

null | string

Tipo MIME dos bytes armazenados, ou null quando desconhecido.

assets[].path

obrigatório

string (comprimento mínimo: 1)

Localização atual mutável em relação ao Workspace. Uma renomeação torna o caminho anterior desatualizado; uma sobrescrita pode alterar os bytes nesse caminho.

assets[].sha256
string

Soma de verificação SHA-256 em letras minúsculas dos bytes armazenados, quando disponível.

Padrão de validação (expressão regular)^[a-f0-9]{64}$
assets[].size

obrigatório

integer (mínimo: 0, máximo: 9007199254740991)

Tamanho do arquivo armazenado em bytes.

assets[].version_id

obrigatório

string

Versão exata e imutável deste ativo. Use em conjunto com asset_id para selecionar os bytes retidos; se a versão estiver ausente, a versão atual nunca será usada como alternativa.

Padrão de validação (expressão regular)^[A-Za-z0-9_-]{21}[AQgw]$
assets[].width
integer (mínimo exclusivo: 0, máximo: 9007199254740991)

Largura de exibição em pixels, após a aplicação da orientação EXIF, quando conhecida.

assets[].workspace

obrigatório

string (comprimento mínimo: 1)

Slug do Workspace ao qual este ativo pertence. Autentique-se no mesmo Workspace ao ler ou gerenciar este ativo.

message

obrigatório

string (comprimento mínimo: 1)
next_cursor

obrigatório

null | string
ok

obrigatório

string (sempre: "DAM_ASSETS_LISTED")
workspace

obrigatório

string (comprimento mínimo: 1)

Slug do Workspace ao qual este ativo pertence. Autentique-se no mesmo Workspace ao ler ou gerenciar este ativo.

Resposta de erro

Corpo da resposta JSON. application/json text/plain; charset=utf-8

Esquema do corpo da resposta
Esquema JSON completo

Abrir JSON em uma nova aba

Pelo menos uma destas propriedades é obrigatória: error, message, reason

A resposta pode conter campos adicionais.

CampoTipo e descrição
assembly_id
string
error
string (comprimento mínimo: 1)
http_code
number | string
  • number
  • string
    Padrão de validação (expressão regular)^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]*[+-]?0*(?:0(?:[^0-9]|$)|(?:[1-9][0-9]{0,307}|1(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-5][0-9]{4}|7976[0-8][0-9]{3}|79769[0-2][0-9]{2}|7976930[0-9]{1}|7976931[0-2])[0-9]{300}|79769313(?:(?:[0-3][0-9]{7}|4[0-7][0-9]{6}|48[0-5][0-9]{5}|486[0-1][0-9]{4}|4862[0-2][0-9]{3}|486230[0-9]{2}|486231[0-4][0-9]{1}|4862315[0-7])[0-9]{292}|48623158(?:(?:0[0-6][0-9]{6}|07[0-8][0-9]{5}|079[0-2][0-9]{4}|0793[0-6][0-9]{3}|07937[0-1][0-9]{2}|079372[0-7][0-9]{1}|0793728[0-8])[0-9]{284}|07937289(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-3][0-9]{5}|7140[0-4][0-9]{3}|71405[0-2][0-9]{2}|7140530[0-2])[0-9]{276}|71405303(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-4][0-9]{5}|4150[0-6][0-9]{3}|41507[0-8][0-9]{2}|415079[0-8][0-9]{1}|4150799[0-2])[0-9]{268}|41507993(?:(?:[0-3][0-9]{7}|40[0-9]{6}|41[0-2][0-9]{5}|413[0-1][0-9]{4}|4132[0-6][0-9]{3}|413270[0-9]{2})[0-9]{260}|41327100(?:(?:[0-2][0-9]{7}|3[0-6][0-9]{6}|37[0-7][0-9]{5}|378[0-1][0-9]{4}|3782[0-5][0-9]{3}|37826[0-8][0-9]{2}|378269[0-2][0-9]{1}|3782693[0-5])[0-9]{252}|37826936(?:(?:0[0-9]{7}|1[0-6][0-9]{6}|17[0-2][0-9]{5}|173[0-6][0-9]{4}|1737[0-6][0-9]{3}|17377[0-7][0-9]{2}|173778[0-8][0-9]{1}|1737789[0-7])[0-9]{244}|17377898(?:(?:0[0-3][0-9]{6}|04[0-3][0-9]{5}|044[0-3][0-9]{4}|0444[0-8][0-9]{3}|04449[0-5][0-9]{2}|044496[0-7][0-9]{1}|0444968[0-1])[0-9]{236}|04449682(?:(?:[0-8][0-9]{7}|9[0-1][0-9]{6}|92[0-6][0-9]{5}|927[0-5][0-9]{4}|9276[0-3][0-9]{3}|92764[0-6][0-9]{2}|927647[0-4][0-9]{1})[0-9]{228}|92764750(?:(?:[0-8][0-9]{7}|9[0-3][0-9]{6}|94[0-5][0-9]{5}|946[0-5][0-9]{4}|9466[0-3][0-9]{3}|94664[0-8][0-9]{2}|94664900)[0-9]{220}|94664901(?:(?:[0-6][0-9]{7}|7[0-8][0-9]{6}|79[0-6][0-9]{5}|797[0-6][0-9]{4}|7977[0-4][0-9]{3}|79775[0-7][0-9]{2}|797758[0-6][0-9]{1}|7977587[0-1])[0-9]{212}|79775872(?:(?:0[0-6][0-9]{6}|070[0-8][0-9]{4}|0709[0-5][0-9]{3}|07096[0-2][0-9]{2}|070963[0-2][0-9]{1})[0-9]{204}|07096330(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-5][0-9]{5}|286[0-3][0-9]{4}|28640[0-9]{3}|28641[0-5][0-9]{2}|286416[0-5][0-9]{1}|2864166[0-8])[0-9]{196}|28641669(?:(?:[0-1][0-9]{7}|2[0-7][0-9]{6}|28[0-7][0-9]{5}|288[0-6][0-9]{4}|2887[0-8][0-9]{3}|288790[0-9]{2}|2887910[0-8])[0-9]{188}|28879109(?:(?:[0-3][0-9]{7}|4[0-5][0-9]{6}|46[0-4][0-9]{5}|465[0-4][0-9]{4}|4655[0-4][0-9]{3}|46555[0-4][0-9]{2}|465555[0-3][0-9]{1}|4655554[0-6])[0-9]{180}|46555547(?:(?:[0-7][0-9]{7}|8[0-4][0-9]{6}|850[0-9]{5}|851[0-8][0-9]{4}|8519[0-3][0-9]{3}|851940[0-3][0-9]{1})[0-9]{172}|85194040(?:(?:[0-1][0-9]{7}|2[0-5][0-9]{6}|26[0-2][0-9]{5}|2630[0-5][0-9]{3}|26306[0-4][0-9]{2}|263065[0-6][0-9]{1}|2630657[0-3])[0-9]{164}|26306574(?:(?:[0-7][0-9]{7}|8[0-7][0-9]{6}|88[0-5][0-9]{5}|886[0-6][0-9]{4}|88670[0-9]{3}|88671[0-4][0-9]{2}|8867150[0-4])[0-9]{156}|88671505(?:(?:[0-7][0-9]{7}|8[0-1][0-9]{6}|820[0-5][0-9]{4}|8206[0-7][0-9]{3}|820680[0-9]{2}|820681[0-8][0-9]{1})[0-9]{148}|82068190(?:(?:[0-7][0-9]{7}|8[0-8][0-9]{6}|890[0-1][0-9]{4}|8902000[0-6])[0-9]{140}|89020007(?:(?:0[0-7][0-9]{6}|08[0-2][0-9]{5}|083[0-7][0-9]{4}|0838[0-2][0-9]{3}|08383[0-5][0-9]{2}|083836[0-6][0-9]{1}|0838367[0-5])[0-9]{132}|08383676(?:(?:[0-1][0-9]{7}|2[0-6][0-9]{6}|27[0-2][0-9]{5}|273[0-7][0-9]{4}|2738[0-4][0-9]{3}|27385[0-3][0-9]{2}|273854[0-7][0-9]{1}|2738548[0-3])[0-9]{124}|27385484(?:(?:[0-4][0-9]{7}|5[0-7][0-9]{6}|580[0-9]{5}|581[0-6][0-9]{4}|5817[0-6][0-9]{3}|581770[0-9]{2}|5817710[0-9]{1}|5817711[0-4])[0-9]{116}|58177115(?:(?:[0-2][0-9]{7}|30[0-9]{6}|31[0-6][0-9]{5}|317[0-5][0-9]{4}|3176[0-3][0-9]{3}|31764[0-3][0-9]{2}|317644[0-6][0-9]{1}|3176447[0-4])[0-9]{108}|31764475(?:(?:[0-6][0-9]{7}|7[0-2][0-9]{6}|730[0-1][0-9]{4}|7302[0-6][0-9]{3}|7302700[0-5])[0-9]{100}|73027006(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-4][0-9]{5}|985[0-4][0-9]{4}|9855[0-4][0-9]{3}|98555[0-6][0-9]{2}|9855570[0-9]{1}|9855571[0-2])[0-9]{92}|98555713(?:(?:[0-5][0-9]{7}|6[0-5][0-9]{6}|66[0-8][0-9]{5}|669[0-4][0-9]{4}|6695[0-8][0-9]{3}|66959[0-5][0-9]{2}|669596[0-1][0-9]{1}|6695962[0-1])[0-9]{84}|66959622(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-1][0-9]{5}|842[0-8][0-9]{4}|84290[0-9]{3}|84291[0-3][0-9]{2}|842914[0-7][0-9]{1}|84291480)[0-9]{76}|84291481(?:(?:[0-8][0-9]{7}|9[0-7][0-9]{6}|98[0-5][0-9]{5}|9860[0-7][0-9]{3}|98608[0-2][0-9]{2}|986083[0-3][0-9]{1}|9860834[0-8])[0-9]{68}|98608349(?:(?:[0-2][0-9]{7}|3[0-5][0-9]{6}|36[0-3][0-9]{5}|364[0-6][0-9]{4}|3647[0-4][0-9]{3}|36475[0-1][0-9]{2}|364752[0-8][0-9]{1}|3647529[0-1])[0-9]{60}|36475292(?:(?:[0-6][0-9]{7}|70[0-9]{6}|71[0-8][0-9]{5}|7190[0-6][0-9]{3}|71907[0-3][0-9]{2}|7190740[0-9]{1}|7190741[0-5])[0-9]{52}|71907416(?:(?:[0-7][0-9]{7}|8[0-3][0-9]{6}|84[0-3][0-9]{5}|844[0-3][0-9]{4}|8444[0-2][0-9]{3}|84443[0-5][0-9]{2}|844436[0-4][0-9]{1}|8444365[0-4])[0-9]{44}|84443655(?:(?:0[0-9]{7}|10[0-6][0-9]{5}|1070[0-3][0-9]{3}|10704[0-2][0-9]{2}|107043[0-3][0-9]{1}|1070434[0-1])[0-9]{36}|10704342(?:(?:[0-6][0-9]{7}|70[0-9]{6}|710[0-9]{5}|711[0-4][0-9]{4}|7115[0-4][0-9]{3}|71155[0-8][0-9]{2}|711559[0-5][0-9]{1}|7115596[0-8])[0-9]{28}|71155969(?:(?:[0-8][0-9]{7}|9[0-4][0-9]{6}|950[0-7][0-9]{4}|95080[0-8][0-9]{2}|950809[0-2][0-9]{1})[0-9]{20}|95080930(?:(?:[0-3][0-9]{7}|4[0-1][0-9]{6}|42[0-7][0-9]{5}|428[0-7][0-9]{4}|428800[0-9]{2}|428801[0-6][0-9]{1}|4288017[0-6])[0-9]{12}|42880177(?:(?:[0-8][0-9]{7}|90[0-3][0-9]{5}|9040[0-9]{4}|9041[0-6][0-9]{3}|90417[0-3][0-9]{2}|904174[0-3][0-9]{1}|9041744[0-8])[0-9]{4}|90417449(?:(?:[0-6][0-9]{3}|7[0-6][0-9]{2}|77[0-8][0-9]{1}|7790)|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]|$))
message
string

Explicação do erro legível por humanos. A redação pode variar; use o código error ao tratar uma falha específica.

reason
null | string | number | boolean | Array<qualquer valor> | object

Qualquer um dos esquemas a seguir pode ser aplicado:

null
null
string
string
number
number
boolean
boolean
Array<qualquer valor>
Array<qualquer valor>
Esquema do item do array
qualquer valor
object
object
Esquema de propriedade adicional
qualquer valor