Guida alla migrazione da V2 a V4 | Frame.io API Documentation

Questa guida ti aiuterà a eseguire la migrazione dall’API V3 di Frame.io (talvolta denominata endpoint “tradizionale” o “v2” nella documentazione) all’API V4 di Adobe Frame.io .Rispecchia lo stile e la struttura dell’esempio di migrazione dell’API Dropbox: fornisce una panoramica completa delle mappature degli endpoint, delle modifiche del payload, degli aggiornamenti dell’autenticazione e altro ancora.

Endpoint: mappatura da V3 a V4

Di seguito è riportato un confronto degli endpoint chiave di Frame.io V3 (a sinistra) e dei loro equivalenti V4 (a destra).Questa sezione è ispirata alla tabella “Mappatura v1 → v2” di Dropbox.

Suggerimento: questa tabella si concentra sulle tipiche operazioni per file, cartelle e progetti. Gli endpoint speciali (ad esempio Camera to Cloud) sono omessi.

OAuth e autenticazione

V3	V4
Token sviluppatore (bearer `<token></token>`) o Frame.io OAuth 2.0 con `Authorization: Bearer<token></token>`	Adobe IMS OAuth 2.0 (devi creare un progetto in Adobe Developer Console) e utilizzare: `Authorization: Bearer<adobe_access_token></adobe_access_token>`
Nota: i token sviluppatore tradizionali non possono essere convertiti automaticamente.Devi implementare il nuovo flusso OAuth IMS.Documentazione: Come ottenere un token di accesso Adobe Frame.io

Operazioni per cartelle e file

Crea una cartella

V3 (Crea cartella):

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	}