Frame.io API V3 → V4 迁移指南

以下指南将帮助您从 Frame.io API V3(在文档中有时称为“旧版”或“v2”端点)迁移到 Adobe Frame.io API V4。这参照了 Dropbox API 迁移示例的风格和结构,为您全面展示端点映射、负载更改、身份验证更新等内容。



端点:V3 → V4 映射

以下是 Frame.io V3 关键端点(左侧)与其 V4 对应端点(右侧)的并排对比。本部分灵感来自 Dropbox“v1 → v2 映射”表格。

**提示:**此表格侧重于典型的文件、文件夹和项目操作。专用端点(例如,Camera to Cloud)已被省略。

OAuth 与身份验证

V3V4
开发者令牌(Bearer <token></token>)或使用 Authorization: Bearer 的 Frame.io OAuth 2.0<token></token>Adobe IMS OAuth 2.0(必须在 Adobe Developer Console 中创建一个项目)并使用:Authorization: Bearer<adobe_access_token></adobe_access_token>
**注意:**旧版开发者令牌无法自动转换。您必须实施新的 IMS OAuth 流程。文档:如何获取 Adobe Frame.io 访问令牌

文件夹和文件操作

创建文件夹

  • V3(创建文件夹):
1POST /v2/assets/{parent_asset_id}/children
2
3
4
5
6Content-Type: application/json
7
8
9
10
11
12{
13
14
15
16
17&quot;name&quot;: &quot;My New Folder&quot;,
18
19
20
21
22&quot;type&quot;: &quot;folder&quot;
23
24
25
26
27}