Руководство по переносу с V2 на V4

Это руководство поможет вам перейти с Frame.io API V3 (иногда называемого «устаревшим» или конечной точкой «v2» в документации) на Adobe Frame.io API V4. Это отражает стиль и структуру примера переноса Dropbox API, предоставляя вам полный обзор сопоставления конечных точек, изменений полезной нагрузки, обновлений аутентификации и многого другого.

Конечные точки: сопоставление V3 и V4

Ниже приведено параллельное сравнение ключевых конечных точек Frame.io V3 (слева) и их эквивалентов V4 (справа). Этот раздел создан по аналогии с таблицей сопоставления 1 и v2 от Dropbox.

Совет. В этой таблице основное внимание уделяется типичным операциям с файлами, папками и проектами. Специализированные конечные точки (например, «С камеры в облако») не включены.

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

V3	V4
Токен разработчика (Bearer `<token></token>`) или Frame.io OAuth 2.0 с `Authorization: Bearer<token></token>`	Adobe IMS OAuth 2.0 (необходимо создать проект в Adobe Developer Console) и использовать: `Authorization: Bearer<adobe_access_token></adobe_access_token>`
Примечание. Устаревшие токены разработчика не могут быть автоматически конвертированы. Вы должны реализовать новый поток IMS OAuth. Документация: как получить токен доступа Adobe Frame.io

Операции с папками и файлами

Создание папки

V3 (Создание папки):

1 POST /v2/assets/{parent_asset_id}/children
2 
3 
4   
5 
6 Content-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 }

1	POST /v2/assets/{parent_asset_id}/children
2
3
4
5
6	Content-Type: application/json
7
8
9
10
11
12	{
13
14
15
16
17	"name": "My New Folder",
18
19
20
21
22	"type": "folder"
23
24
25
26
27	}