Introduzione

Avvio rapido

Questa guida illustra il percorso più veloce per effettuare la prima chiamata dell’API Frame.io V4. Devi creare un progetto in Adobe Developer Console, generare le credenziali ed effettuare la prima richiesta API.

Passaggio 1: crea un progetto in Adobe Developer Console e aggiungi l’API Frame.io V4

Da Adobe Developer Console, crea un nuovo progetto e aggiungi l’API Frame.io V4.

Questa guida utilizza la web app OAuth 2.0 per l’autenticazione. Per informazioni su altri metodi, consulta la guida all’autenticazione

Passaggio 2: Configura l’applicazione

Seleziona la web app OAuth come tipo di applicazione e imposta i campi di reindirizzamento.

URI di reindirizzamentoUna route nella tua applicazione che riceve la risposta di OAuth da Adobe IMS. Dopo che un utente accede e approva l’accesso, Adobe IMS lo reindirizza a questo URL con un codice di autorizzazione nella stringa di richiesta, che la tua app scambia poi per un token di accesso
Pattern per l’URI di reindirizzamentoPattern che corrispondono a URL di reindirizzamento aggiuntivi oltre all’URI di reindirizzamento predefinito. Ciò è utile se la tua app funziona in più ambienti o utilizza il routing dinamico. I pattern multipli devono essere forniti come un elenco separato da virgole

Passaggio 3: autenticazione

Avvia il flusso OAuth reindirizzando l’utente all’endpoint di autorizzazione di Adobe IMS:

  https://ims-na1.adobelogin.com/ims/authorize/v2
  ?client_id={CLIENT_ID}
  &redirect_uri={REDIRECT_URI}
  &scope=offline_access,openid,email,profile,additional_info.roles
  &response_type=code

Dopo che l’utente ha effettuato l’accesso e ha approvato l’accesso, Adobe IMS lo porta all’URI di reindirizzamento configurato con un codice di autorizzazione nella stringa di richiesta. Scambia quel codice con un token di accesso inviando una richiesta POST all’endpoint del token IMS.


Ecco un elenco delle definizioni dei parametri con una richiesta e una risposta di esempio:

ParametroObbligatorioDescrizione
codeSìIl valore della stringa di richiesta del codice restituito al redirect_uri quando un utente si autentica nell’applicazione
grant_typeSìIl valore deve sempre essere authorization_code
authorizationObbligatorio per client riservati
Richiesta di esempio
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
  -H 'Authorization: Basic {AUTHORIZATION}' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'code={CODE}&grant_type=authorization_code'

Risposta di esempio

{
    "access_token": "{ACCESS_TOKEN}",
    "refresh_token": "{REFRESH_TOKEN}",
    "sub": "B0DC108C5CD449CA0A494133@c62f24cc5b5b7e0e0a494004",
    "id_token": "{ID_TOKEN}",
    "token_type": "bearer",
    "expires_in": 86399
}
Supporto dell'SDK

Sia l’SDK Python che l’SDK TypeScript includono moduli di autenticazione che gestiscono l’handshake OAuth, lo scambio di token e l’aggiornamento automatico dei token. Puoi trovare maggiori informazioni su ciascuno qui:

Python | TypeScript

Passaggio 4: esegui le tue prime richieste API

Per prima cosa, usa il token di accesso per chiamare l’endpoint /v4/me:

curl https://api.frame.io/v4/me \
-H "Authorization: Bearer <token>"

Questa richiesta chiama l’API Adobe IMS per verificare il token e le informazioni utente.

Una richiesta riuscita restituirà i dettagli sull’utente autenticato, inclusi user_id, nome ed e-mail. Usala per confermare che il flusso di autenticazione funzioni come previsto.

La maggior parte degli endpoint API V4 richiede un account_id, che non viene restituito da /v4/me. Per ottenere l’account_id, fai una richiesta a /v4/accounts:

curl https://api.frame.io/v4/accounts \
-H "Authorization: Bearer <token>"

Viene restituito l’elenco degli account disponibili per l’utente autenticato. Usa l’account_id di questa risposta nelle successive richieste API.

Differenza tra ID utente e ID account

Lo user_id ti identifica come singolo utente, mentre l’account_id rappresenta l’organizzazione a cui appartieni. La maggior parte degli endpoint V4 opera a livello di account.

Passaggi successivi

Con l’autenticazione attiva e l’account_id, sei pronto per iniziare a lavorare con l’API Frame.io. Queste risorse possono aiutarti per iniziare: