Datei anzeigen | 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"
      }
    }
  }
}

Dateidetails anzeigen.

Beziehen Sie mit dem Abfrageparameter ‘include’ selektiv zusätzliche Eigenschaften in die Antwort ein.

Hinweis: Wenn Sie ‘media_links.original’ einbeziehen und die Benutzenden keine Berechtigung zum Herunterladen von Dateien im entsprechenden Projekt haben, wird von diesem Endpunkt der Fehler ‘403 Forbidden’ ausgegeben. Ist der Inhalt nicht zugänglich, weil für diesen Benutzer bzw. diese Benutzerin ein Wasserzeichen erforderlich ist und von den angeforderten media_links nicht unterstützt wird, ist die Anfrage erfolgreich, aber die nicht unterstützten Medien-Links werden auf Null gesetzt. Ähnlich verhält es sich, wenn ein angeforderter Transcode-Link für eine bestimmte Datei nicht existiert (z. B. das Einbinden von ‘media_links.video_h264_180’ in eine statische Bilddatei) oder die Transkodierung nicht abgeschlossen ist (d. h., der Status der Datei lautet „hochgeladen“ anstatt „transkodiert“); dann wird der Medienlink in der Antwort-Payload ebenfalls auf Null gesetzt. Kurz gesagt, der Client muss Null-Medien-Links elegant verarbeiten.
Ratenbegrenzungen: 10 Aufrufe pro 1 Minute(n) pro account_user

Dateidetails anzeigen. <br/> Beziehen Sie mit dem Abfrageparameter 'include' selektiv zusätzliche Eigenschaften in die Antwort ein. <br/> Hinweis: Wenn Sie 'media_links.original' einbeziehen und die Benutzenden keine Berechtigung zum Herunterladen von Dateien im entsprechenden Projekt haben, wird von diesem Endpunkt der Fehler '403 Forbidden' ausgegeben. Ist der Inhalt nicht zugänglich, weil für diesen Benutzer bzw. diese Benutzerin ein Wasserzeichen erforderlich ist und von den angeforderten media_links nicht unterstützt wird, ist die Anfrage erfolgreich, aber die nicht unterstützten Medien-Links werden auf Null gesetzt. Ähnlich verhält es sich, wenn ein angeforderter Transcode-Link für eine bestimmte Datei nicht existiert (z. B. das Einbinden von 'media_links.video_h264_180' in eine statische Bilddatei) oder die Transkodierung nicht abgeschlossen ist (d. h., der Status der Datei lautet „hochgeladen“ anstatt „transkodiert“); dann wird der Medienlink in der Antwort-Payload ebenfalls auf Null gesetzt. Kurz gesagt, der Client muss Null-Medien-Links elegant verarbeiten. <br/>Ratenbegrenzungen: 10 Aufrufe pro 1 Minute(n) pro account_user

Authentifizierung

AuthorizationBearer

Bearer-Authentifizierung der Form Bearer <token>, wobei token Ihr Auth-Token ist.

Pfadparameter

account_idstringErforderlich

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix ‘adobe:’ haben (z. B. ‘adobe:<adobe_org_id>’ für ein Konto, ‘adobe:<adobe_asset_id>’ für ein Projekt oder einen Ordner, ‘adobe:<adobe_asset_id>|<version>’ für ein Datei-Asset).

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix 'adobe:' haben (z. B. 'adobe:<adobe_org_id>' für ein Konto, 'adobe:<adobe_asset_id>' für ein Projekt oder einen Ordner, 'adobe:<adobe_asset_id>|<version>' für ein Datei-Asset).

file_idstringErforderlich

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix 'adobe:' haben (z. B. 'adobe:<adobe_org_id>' für ein Konto, 'adobe:<adobe_asset_id>' für ein Projekt oder einen Ordner, 'adobe:<adobe_asset_id>|<version>' für ein Datei-Asset).

Abfrageparameter

includeenumOptional

Unterstützt werden unter anderem Abfrageparameterwerte für Endpunkte, die Dateien mit Medien-Links ausgeben

Antwort-Header

x-ratelimit-limitinteger

Rate-Limit

x-ratelimit-remaininginteger

Verbleibendes Rate-Limit

x-ratelimit-windowinteger

Rate-Limit-Fenster in Millisekunden

Antwort

dataobject

Fehler

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

Dateidetails anzeigen.

Beziehen Sie mit dem Abfrageparameter ‘include’ selektiv zusätzliche Eigenschaften in die Antwort ein.