Guia de migração da API V3 → V4 do Frame.io

O guia a seguir ajuda na migração da API V3 do Frame.io (às vezes chamada de ponto de acesso “legado” ou “v2” na documentação) para a API V4 do Adobe Frame.io.Isso reflete o estilo e a estrutura do exemplo de migração da API do Dropbox, oferecendo uma visão abrangente dos mapeamentos de pontos de acesso, alterações de conteúdo, atualizações de autenticação e muito mais.



Pontos de acesso: mapeamento V3 → V4

A seguir, uma comparação lado a lado dos principais pontos de acesso V3 do Frame.io (à esquerda) e seus equivalentes V4 (à direita).Esta seção é inspirada na tabela “mapeamento v1 → v2” do Dropbox.

Dica: esta tabela foca nas operações típicas de arquivo, pasta e projeto.Pontos de acesso especializados (por exemplo, Camera to Cloud) são omitidos.

OAuth e autenticação

V3V4
Token do desenvolvedor (Bearer <token></token>) ou Frame.io OAuth 2.0 com Authorization: Bearer<token></token>Adobe IMS OAuth 2.0 (é preciso criar um projeto no Adobe Developer Console) e usar: Authorization: Bearer<adobe_access_token></adobe_access_token>
Observação: tokens de desenvolvedor legados não podem ser convertidos automaticamente.É preciso implementar o novo fluxo OAuth do IMS.Documentação: Como obter um token de acesso do Adobe Frame.io

Operações de pasta e arquivo

Criar uma pasta

  • V3 (Criar pasta):
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}