Создать список стеков версий

GET

https://api.frame.io/v4/accounts/:account_id/folders/:folder_id/version_stacks

GET

/v4/accounts/:account_id/folders/:folder_id/version_stacks

1 from frameio import Frameio
2 
3 client = Frameio(
4     token="YOUR_TOKEN_HERE",
5 )
6 
7 client.version_stacks.list(
8     account_id="707b3009-f7a2-41d7-a89a-6583339017cc",
9     folder_id="46aa5062-baf8-4bcf-a4a0-0af4122b99b7",
10 )

1 {
2   "data": [
3     {
4       "head_version": {
5         "created_at": "2023-09-25T19:18:29.614189Z",
6         "file_size": 1137444,
7         "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
8         "media_type": "image/png",
9         "name": "asset.png",
10         "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
11         "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
12         "status": "created",
13         "type": "file",
14         "updated_at": "2024-02-07T16:44:41.986478Z",
15         "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
16         "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
17         "adobe_version_id": "2",
18         "creator": {
19           "active": true,
20           "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",
21           "email": "user_email@example.com",
22           "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
23           "name": "Jon Doe"
24         },
25         "media_links": {
26           "high_quality": {
27             "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"
28           },
29           "original": {
30             "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",
31             "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"
32           },
33           "thumbnail": {
34             "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",
35             "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"
36           }
37         },
38         "metadata": [
39           {
40             "field_type": "select",
41             "field_definition_id": "36279dd3-a607-432e-ad85-2005522b3c4e",
42             "field_definition_name": "Fields definition name",
43             "mutable": true,
44             "value": [
45               {
46                 "display_name": "Display name",
47                 "id": "6711d43d-b717-4765-bde4-994bf39f88df"
48               }
49             ],
50             "field_options": [
51               {
52                 "display_name": "Display name",
53                 "id": "6711d43d-b717-4765-bde4-994bf39f88df"
54               },
55               {
56                 "display_name": "Display name 2",
57                 "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
58               }
59             ]
60           }
61         ],
62         "project": {
63           "created_at": "2024-01-25T19:18:29.614189Z",
64           "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
65           "name": "My Project",
66           "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
67           "status": "active",
68           "storage": 15000,
69           "updated_at": "2024-02-07T16:44:41.986478Z",
70           "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
71           "workspace_id": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
72           "description": "Project Description",
73           "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
74           "restricted": false,
75           "owner": {
76             "active": true,
77             "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",
78             "email": "user_email@example.com",
79             "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
80             "name": "Jon Doe"
81           }
82         }
83       },
84       "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
85       "name": "asset.png",
86       "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
87       "created_at": "2023-09-25T19:18:29.614189Z",
88       "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
89       "type": "file",
90       "updated_at": "2024-02-07T16:44:41.986478Z",
91       "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
92       "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
93       "creator": {
94         "active": true,
95         "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",
96         "email": "user_email@example.com",
97         "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
98         "name": "Jon Doe"
99       },
100       "metadata": [
101         {
102           "field_type": "select",
103           "field_definition_id": "36279dd3-a607-432e-ad85-2005522b3c4e",
104           "field_definition_name": "Fields definition name",
105           "mutable": true,
106           "value": [
107             {
108               "display_name": "Display name",
109               "id": "6711d43d-b717-4765-bde4-994bf39f88df"
110             }
111           ],
112           "field_options": [
113             {
114               "display_name": "Display name",
115               "id": "6711d43d-b717-4765-bde4-994bf39f88df"
116             },
117             {
118               "display_name": "Display name 2",
119               "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
120             }
121           ]
122         }
123       ],
124       "project": {
125         "created_at": "2024-01-25T19:18:29.614189Z",
126         "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
127         "name": "My Project",
128         "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
129         "status": "active",
130         "storage": 15000,
131         "updated_at": "2024-02-07T16:44:41.986478Z",
132         "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
133         "workspace_id": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
134         "description": "Project Description",
135         "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
136         "restricted": false,
137         "owner": {
138           "active": true,
139           "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",
140           "email": "user_email@example.com",
141           "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
142           "name": "Jon Doe"
143         }
144       }
145     }
146   ],
147   "links": {
148     "next": "/v4/accounts/123/folders/123/version_stacks"
149   },
150   "total_count": 10
151 }

Создание списка стеков версий в указанной папке.
Лимиты запросов: 5 вызовов за 1 сек. для account_user

Аутентификация

AuthorizationBearer

Аутентификация Bearer в форме Bearer <token>, где token — ваш токен аутентификации.

Параметры пути

account_idstringОбязательный

Идентификатор сущности Frame.io или Adobe. Обычно это UUID Frame.io. Но для учетных записей, проектов, папок, файлов и стеков версий, которые хранятся в облачном хранилище Adobe (что характерно для учетных записей и проектов, подключенных к Workfront), в качестве идентификатора также может использоваться назначенный идентификатор Adobe. Эти идентификаторы должны иметь префикс adobe: (например, adobe:<adobe_org_id> для учетной записи, adobe:<adobe_asset_id> для проекта или папки, adobe:adobe:<adobe_asset_id>|<version> для файла).

folder_idstringОбязательный

Параметры запроса

includeenumОпциональный

Поддерживаемые значения параметра запроса для включения конечных точек, которые возвращают файлы со ссылками на медиафайлы

afterstringОпциональный

Параметр запроса “Непрозрачный курсор” для запросов, возвращающих результаты с разбивкой на страницы.

ПРИМЕЧАНИЕ. Это автоматически создаваемое значение, которое включается как часть ссылок из предыдущего ответа. Оно не предназначено для чтения пользователями.

Параметр запроса "Непрозрачный курсор" для запросов, возвращающих результаты с разбивкой на страницы. <br/> ПРИМЕЧАНИЕ. Это автоматически создаваемое значение, которое включается как часть ссылок из предыдущего ответа. Оно не предназначено для чтения пользователями.

page_sizeintegerОпциональный1-500По умолчанию 50

Параметр запроса размера страницы для запросов списка ресурсов

include_total_countbooleanОпциональныйПо умолчанию false

Параметр запроса страницы для включения количества всех объектов

Заголовки ответа

x-ratelimit-limitinteger

Лимит запросов

x-ratelimit-remaininginteger

Остаток лимита запросов

x-ratelimit-windowinteger

Окно лимита запросов (в мс)

Ответ

ОК

datalist of objects

linksobject

Ссылки на данные с разбиением на страницы

total_countinteger or nullОпциональный

Общее количество

Ошибки

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