Flusso di registrazione client dinamici dynamic-client-registration-flow
Accedere alle API protette di Adobe Pass access-adobe-pass-protected-apis
Prerequisiti prerequisites-access-adobe-pass-protected-apis
Prima di accedere alle API protette di Adobe Pass, assicurati di soddisfare i seguenti prerequisiti:
- Un rappresentante del client deve creare un'applicazione registrata come descritto nella sezione Gestione applicazioni registrate.
- Un rappresentante del client deve scaricare e incorporare un'istruzione software come descritto nella sezione Gestione istruzioni software.
Flusso di lavoro workflow-access-adobe-pass-protected-apis
Segui i passaggi forniti per accedere alle API protette da Adobe Pass, come illustrato nel diagramma seguente.
Accesso alle API protette di Adobe Pass
-
Recupera credenziali client: L'applicazione client raccoglie tutti i dati necessari per recuperare le credenziali client chiamando l'endpoint Registro client.
note important IMPORTANT Per informazioni dettagliate su Recuperare le credenziali del client, consulta la documentazione API di: - Tutti i parametri required, come
software_statement
- Tutte le intestazioni required, come
Content-Type
,X-Device-Info
- Tutti i parametri e le intestazioni optional
- Tutti i parametri required, come
-
Restituisci credenziali client: La risposta dell'endpoint Registro client contiene informazioni sulle credenziali client associate ai parametri e alle intestazioni ricevuti.
note important IMPORTANT Per informazioni dettagliate sulle informazioni fornite in una risposta alle credenziali del client, consultare la documentazione API Recupera credenziali client. Il registro client convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base: - I parametri e le intestazioni required devono essere validi.
Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione API Retrieve client credentials. note tip TIP Suggerimento: le credenziali del client devono essere memorizzate nella cache e possono essere utilizzate a tempo indefinito. -
Recupera token di accesso: L'applicazione client raccoglie tutti i dati necessari per recuperare il token di accesso chiamando l'endpoint del token client.
note important IMPORTANT Per informazioni dettagliate su Recupera token di accesso, consulta la documentazione API di: - Tutti i parametri required, come
client_id
,client_secret
egrant_type
- Tutte le intestazioni required, come
Content-Type
,X-Device-Info
- Tutti i parametri e le intestazioni optional
- Tutti i parametri required, come
-
Token di accesso restituito: La risposta dell'endpoint del token client contiene informazioni sul token di accesso associato ai parametri e alle intestazioni ricevuti.
note important IMPORTANT Per informazioni dettagliate sulle informazioni fornite in una risposta del token di accesso, consulta la documentazione API Recupera token di accesso. Il token client convalida i dati della richiesta per garantire che siano soddisfatte le condizioni di base: - I parametri e le intestazioni required devono essere validi.
Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione API Recupera token di accesso. note tip TIP Suggerimento: il token di accesso deve essere memorizzato in cache e utilizzato solo entro la durata specificata (ad esempio, time-to-live di 24 ore). Dopo la scadenza, l’applicazione client deve richiedere un nuovo token di accesso. -
Procedere con l'accesso alle API protette: L'applicazione client utilizza il token di accesso per accedere ad altre API protette di Adobe Pass. L'applicazione client deve includere il token di accesso nell'intestazione della richiesta
Authorization
utilizzando lo schema di autenticazioneBearer
(ovveroAuthorization: Bearer <access_token>
).note important IMPORTANT Le API protette di Adobe Pass convalidano il token di accesso per garantire che siano soddisfatte le condizioni di base: - access_token deve essere valido.
- Il access_token deve essere associato a un client_id e a un client_secret validi.
- Il access_token deve essere associato a un software_statement valido.
Se la convalida non riesce, verrà generata una risposta di errore che fornirà informazioni aggiuntive conformi alla documentazione di Codici di errore avanzati.