파일 표시 | Frame.io API Documentation

from frameio import Frameio
client = Frameio(
    token="YOUR_TOKEN_HERE",
)
client.files.show(
    account_id="1ac65329-74b2-41ac-9393-eaa4263bbaea",
    file_id="29c50925-6246-492f-8f55-e2e9b1197c46",
    include="media_links.original",
)

{
  "data": {
    "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",
    "type": "file",
    "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"
      }
    }
  }
}

파일 세부 정보를 표시합니다.

include 쿼리 파라미터를 사용하여 응답에 추가 속성을 선택적으로 포함할 수 있습니다.

참고: media_links.original을 포함했는데 사용자가 해당 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 403 Forbidden 오류를 반환합니다. 사용자에게 워터마킹이 필요하지만 요청된 media_links에서 지원되지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청한 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 media_links.video_h264_180 포함), 트랜스코딩 프로세스가 완료되지 않은 경우 (즉, 파일의 status가 “transcoded”가 아닌 “uploaded”인 경우), 미디어 링크는 응답 페이로드에서 null로 설정됩니다. 즉, 클라이언트는 null 미디어 링크를 적절히 처리해야 합니다.
요청 제한: account_user당 1초당 10회 호출

파일 세부 정보를 표시합니다. <br/> `include` 쿼리 파라미터를 사용하여 응답에 추가 속성을 선택적으로 포함할 수 있습니다. <br/> 참고: `media_links.original`을 포함했는데 사용자가 해당 파일을 다운로드할 권한이 없는 경우, 이 엔드포인트는 `403 Forbidden` 오류를 반환합니다. 사용자에게 워터마킹이 필요하지만 요청된 media_links에서 지원되지 않아 콘텐츠에 액세스할 수 없는 경우, 요청은 성공하지만 지원되지 않는 미디어 링크는 null로 설정됩니다. 마찬가지로 특정 파일에 대해 요청한 트랜스코드 링크가 존재하지 않거나(예: 정적 이미지 파일에 `media_links.video_h264_180` 포함), 트랜스코딩 프로세스가 완료되지 않은 경우 (즉, 파일의 `status`가 "transcoded"가 아닌 "uploaded"인 경우), 미디어 링크는 응답 페이로드에서 null로 설정됩니다. 즉, 클라이언트는 null 미디어 링크를 적절히 처리해야 합니다. <br/>요청 제한: account_user당 1초당 10회 호출

인증

AuthorizationBearer

Bearer <token> 형식의 Bearer 인증. 여기서 token은 인증 토큰입니다.

경로 매개변수

account_idstring필수

Frame.io 또는 Adobe 엔터티 식별자입니다. 일반적으로 Frame.IO UUID입니다. 그러나 Workfront에 연결된 계정 및 프로젝트의 경우 Adobe 클라우드 스토리지에 상주하는 계정, 프로젝트, 폴더, 파일 및 버전 스택의 경우 Adobe에서 할당한 ID를 서로 바꿔 사용할 수도 있습니다. 이러한 ID는 접두사로 adobe:(예: 계정의 경우 adobe:<adobe_org_id>, 프로젝트나 폴더의 경우 adobe:<adobe_asset_id>, 파일 에셋의 경우 adobe:adobe:<adobe_asset_id>|<version>`)를 붙여야 합니다.

Frame.io 또는 Adobe 엔터티 식별자입니다. 일반적으로 Frame.IO UUID입니다. 그러나 Workfront에 연결된 계정 및 프로젝트의 경우 Adobe 클라우드 스토리지에 상주하는 계정, 프로젝트, 폴더, 파일 및 버전 스택의 경우 Adobe에서 할당한 ID를 서로 바꿔 사용할 수도 있습니다. 이러한 ID는 접두사로 `adobe:`(예: 계정의 경우 `adobe:<adobe_org_id>`, 프로젝트나 폴더의 경우 `adobe:<adobe_asset_id>`, 파일 에셋의 경우 `adobe:`adobe:<adobe_asset_id>|<version>`)를 붙여야 합니다.

file_idstring필수

쿼리 매개변수

includeenum선택 사항

미디어 링크가 포함된 파일을 반환하는 엔드포인트에서 지원되는 include 쿼리 매개변수 값

응답 헤더

x-ratelimit-limitinteger

요청 제한

x-ratelimit-remaininginteger

남은 요청 제한

x-ratelimit-windowinteger

요청 제한 기간(밀리초)

응답

확인

dataobject

오류

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

파일 세부 정보를 표시합니다.

include 쿼리 파라미터를 사용하여 응답에 추가 속성을 선택적으로 포함할 수 있습니다.