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 및 인증

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	}