Listar arquivos | Frame.io API Documentation

from frameio import Frameio
client = Frameio(
    token="YOUR_TOKEN_HERE",
)
client.files.list(
    account_id="8ba6bdf3-56d0-42fe-a0bc-5669cc693e53",
    folder_id="dc0fda24-ef56-44c0-b2ee-85fafd8267ca",
)

{
  "data": [
    {
      "type": "file",
      "created_at": "2023-09-25T19:18:29.614189Z",
      "file_size": 1137444,
      "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
      "media_type": "image/png",
      "name": "asset.png",
      "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
      "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
      "status": "created",
      "updated_at": "2024-02-07T16:44:41.986478Z",
      "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
      "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "adobe_version_id": "2",
      "creator": {
        "active": true,
        "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
        "email": "user_email@example.com",
        "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
        "name": "Jon Doe"
      },
      "media_links": {
        "high_quality": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN"
        },
        "original": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "inline_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=inline%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragSDFXDFh&1Key-Pair-Id=KKI497NESTHMN"
        },
        "thumbnail": {
          "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "url": "https://picture2.frame.io/image/s3://frameio-assets-development/image/cd58cb8e-24b3-4498-8d0f-9532fcd04d11/image_full.png?alg=HS256&sig=0_u7w_wz2MwQHOXp000ibbQSMRijujyaUu8V3YYPxu4&exp=1729857600"
        }
      },
      "metadata": [
        {
          "field_type": "select",
          "field_definition_id": "36279dd3-a607-432e-ad85-2005522b3c4e",
          "field_definition_name": "Fields definition name",
          "mutable": true,
          "value": [
            {
              "display_name": "Display name",
              "id": "6711d43d-b717-4765-bde4-994bf39f88df"
            }
          ],
          "field_options": [
            {
              "display_name": "Display name",
              "id": "6711d43d-b717-4765-bde4-994bf39f88df"
            },
            {
              "display_name": "Display name 2",
              "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
            }
          ]
        }
      ],
      "project": {
        "created_at": "2024-01-25T19:18:29.614189Z",
        "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
        "name": "My Project",
        "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
        "status": "active",
        "storage": 15000,
        "updated_at": "2024-02-07T16:44:41.986478Z",
        "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
        "workspace_id": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
        "description": "Project Description",
        "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
        "restricted": false,
        "owner": {
          "active": true,
          "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
          "email": "user_email@example.com",
          "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
          "name": "Jon Doe"
        }
      }
    }
  ],
  "links": {
    "next": "/v4/accounts/123/folders/123/files"
  },
  "total_count": 10
}

Listar arquivos em uma determinada pasta.
Limites de taxa: 5 chamadas por 1 segundo por account_user

Autenticação

AuthorizationBearer

Autenticação bearer na forma Bearer <token>, onde token é seu token de autenticação.

Parâmetros de caminho

account_idstringObrigatório

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com adobe: (por exemplo, adobe:<adobe_org_id> para uma conta, adobe:<adobe_asset_id> para um projeto ou pasta e adobe:<adobe_asset_id>|<version> para um arquivo).

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com `adobe:` (por exemplo, `adobe:<adobe_org_id>` para uma conta, `adobe:<adobe_asset_id>` para um projeto ou pasta e `adobe:<adobe_asset_id>|<version>` para um arquivo).

folder_idstringObrigatório

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com `adobe:` (por exemplo, `adobe:<adobe_org_id>` para uma conta, `adobe:<adobe_asset_id>` para um projeto ou pasta e `adobe:<adobe_asset_id>|<version>` para um arquivo).

Parâmetros de consulta

includeenumOpcional

Valores compatíveis do parâmetro de consulta include para pontos de acesso que retornam arquivos com links de mídia

sortenumOpcional

Ordenar arquivos por parâmetros de consulta

afterstringOpcional

Parâmetro de consulta Cursor opaco para solicitações que retornam resultados paginados.
OBSERVAÇÃO: este valor é gerado automaticamente e incluído como parte dos links de uma resposta anterior. Ele não foi projetado para ser legível por humanos.

page_sizeintegerOpcional1-500Padrão é 50

Parâmetro de consulta de tamanho da página para solicitações de lista de ativos

include_total_countbooleanOpcionalPadrão é false

Parâmetro de consulta de página para incluir a contagem de todas as entidades

Cabeçalhos de resposta

x-ratelimit-limitinteger

Limite de taxa

x-ratelimit-remaininginteger

Limite de taxa restante

x-ratelimit-windowinteger

Janela do limite de taxa em milissegundos

Resposta

datalist of objects

Ativos

linksobject

Links para dados paginados

total_countinteger or nullOpcional

Contagem total

Erros

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error