Recupera token di accesso retrieve-access-token

IMPORTANT
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente di Adobe. Non è consentito alcun uso non autorizzato.
IMPORTANT
L'implementazione dell'API Dynamic Client Registration è limitata dalla documentazione del meccanismo di limitazione.

Richiesta request

HTTP
percorso
/o/client/token
metodo
POST
Parametri corpo
client_id
Stringa dell'identificatore dell'applicazione client.

Per ulteriori informazioni su come ottenere la stringa dell'identificatore client, consultare la documentazione dell'API Recupera credenziali client.
obbligatorio
client_secret
Stringa segreta dell'applicazione client.

Per ulteriori informazioni su come ottenere la stringa del segreto client, consulta la documentazione API Recuperare le credenziali del client.
obbligatorio
grant_type
Stringa del tipo di concessione (ad esempio, "client_credentials") che l’applicazione client può utilizzare per l’endpoint del token client.

Per ulteriori informazioni su come ottenere la stringa del tipo di concessione, consulta la documentazione API Recuperare le credenziali del client.
obbligatorio
Intestazioni
Content-Type
Tipo di file multimediale accettato per le risorse inviate.

Deve essere codificata in application/x-www-form-urlencoded.
obbligatorio
X-Device-Info
La generazione del payload di informazioni sul dispositivo è descritta nella documentazione di X-Device-Info.

Si consiglia vivamente di utilizzarlo sempre quando la piattaforma del dispositivo dell’applicazione consente di fornire esplicitamente valori validi.

Se fornito, il backend di autenticazione di Adobe Pass unirà in modo esplicito i valori con quelli estratti in modo implicito (per impostazione predefinita).

Se non viene fornito, il backend di autenticazione Adobe Pass utilizzerà i valori estratti in modo implicito (per impostazione predefinita).
obbligatorio
Accetta
Tipo di supporto accettato dall'applicazione client.

Se specificato, deve essere application/json.
facoltativo
User-Agent
Agente utente dell’applicazione client.
facoltativo

Risposta response

Completato success

Intestazioni
Stato
201
obbligatorio
Content-Type
application/json
obbligatorio
Corpo

Oggetto JSON con i seguenti attributi:

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 9-bgcolor-deebff 13-bgcolor-deebff 17-bgcolor-deebff 21-bgcolor-deebff layout-auto html-authored
Attributo
id Identificatore opaco che può essere utilizzato per monitorare l’attività dell’utente. obbligatorio
access_token Il valore del token di accesso che l’applicazione client deve utilizzare per l’intestazione Autorizzazione. obbligatorio
created_at L’ora in cui è stato emesso il token di accesso. obbligatorio
expires_in Il tempo in secondi che deve trascorrere prima della scadenza del token di accesso. obbligatorio
token_type Il tipo di token (ad esempio, "bearer"). obbligatorio
obbligatorio

Errore error

Intestazioni
Stato
400
obbligatorio
Content-Type
application/json
obbligatorio
Corpo
errore

I valori possibili sono:

table 0-row-3 1-row-2 2-row-2 3-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff layout-auto html-authored
Valore
invalid_request

La richiesta non è valida per uno dei motivi seguenti:

  • Nella richiesta manca un parametro obbligatorio.
  • La richiesta include un valore di parametro non supportato (diverso dal tipo di concessione).
  • La richiesta ripete un parametro.
  • La richiesta include più credenziali.
  • La richiesta utilizza più di un meccanismo per l’autenticazione del client.
  • Richiesta non valida.
invalid_client Credenziali client non valide. Il client deve ottenere nuove credenziali client e riprovare. Per ulteriori dettagli, consulta la documentazione API Recuperare le credenziali del client.
unauthorized_client Il tipo di concessione utilizzato non è valido.
obbligatorio

Esempi samples

Recupera token di accesso samples-retrieve-access-token

Richiesta
code language-https
POST /o/client/token HTTP/1.1

    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Content-Type: application/x-www-form-urlencoded
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

Body:

client_id=s6BhdRkqt3&client_secret=t7AkePiru4&grant_type=client_credentials
Risposta - Completata
code language-https
HTTP/1.1 201 Created

Content-Type: application/json;charset=UTF-8

{
  "id": "a932f8f0-210a-41a4-b2a8-377751f6b76f",
  "access_token": "2YotnFZFEjr1zCsicMWpAA",
  "created_at": 1723227212,
  "expires_in": 86400,
  "token_type": "bearer"
}
Risposta - Errore
code language-https
HTTP/1.1 400 Bad Request

Content-Type: application/json;charset=UTF-8

{ "error": "invalid_request" }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b