Guide de migration de V2 vers V4 | Frame.io API Documentation

Le Guide suivant vous aide à migrer de Frame.io API V3 (parfois appelé point d’entrée « hérité » ou « v2 » dans la documentation) vers Adobe Frame.io API V4. Cela reflète le style et la structure de l’exemple de migration Dropbox API, vous donnant un aperçu complet des mappages de points d’entrée, des modifications de charge utile, des mises à jour d’authentification, et plus encore.

Points d’entrée : mappage V3 → V4

Voici une comparaison côte à côte des points d’entrée Frame.io V3 clés (à gauche) et leurs équivalents V4 (à droite). Cette section s’inspire du tableau « mappage v1 → v2 » de Dropbox.

Conseil : Ce tableau se concentre sur les opérations de fichiers, dossiers et Projets classiques. Les points d’entrée spécialisés (par exemple, Camera to cloud) sont omis.

OAuth et authentification

V3	V4
Jeton développeur (Bearer `<token></token>`) ou Frame.io OAuth 2.0 avec `Authorization: Bearer<token></token>`	Adobe IMS OAuth 2.0 (doit créer un Projet dans Adobe Developer Console) et utiliser : `Authorization: Bearer<adobe_access_token></adobe_access_token>`
Remarque : Les jetons développeur hérités ne peuvent pas être automatiquement convertis. Vous devez implémenter le nouveau flux OAuth IMS. Documentation : Comment obtenir un jeton d’accès Adobe Frame.io

Opérations de dossiers et fichiers

Créer un dossier

V3 (Créer un dossier) :

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	}