Récupérer le jeton d’accès retrieve-access-token

IMPORTANT
Le contenu de cette page est fourni à titre d’information uniquement. L’utilisation de cette API nécessite une licence Adobe actuelle. Aucune utilisation non autorisée n’est autorisée.
IMPORTANT
L’implémentation de l’API d’enregistrement client dynamique est limitée par la documentation Mécanisme de limitation.

Requête request

HTTP
chemin
/o/client/token
méthode
POSTER
Paramètres du corps
client_id
Chaîne d’identifiant de l’application cliente.

Pour plus d’informations sur l’obtention de la chaîne d’identifiant client, reportez-vous à la documentation de l’API Récupération des informations d’identification client.
obligatoire
client_secret
Chaîne secrète de l’application cliente.

Pour plus d’informations sur l’obtention de la chaîne secrète client, reportez-vous à la documentation de l’API Récupération des informations d’identification client.
obligatoire
grant_type
Chaîne de type d’octroi (par exemple, « client_credentials ») que l’application cliente peut utiliser pour le point d’entrée du jeton client.

Pour plus d’informations sur l’obtention de la chaîne de type d’octroi, consultez la documentation de l’API Récupération des informations d’identification du client.
obligatoire
En-têtes
Content-Type
Type de média accepté pour les ressources en cours d’envoi.

Il doit s’agir de application/x-www-form-urlencoded.
obligatoire
X-Device-Info
La génération de la payload d’informations sur le périphérique est décrite dans la documentation de X-Device-Info.

Il est vivement recommandé de toujours l’utiliser lorsque la plateforme d’appareil de l’application permet la fourniture explicite de valeurs valides.

Lorsqu’il est fourni, le serveur principal d’authentification Adobe Pass fusionne implicitement (par défaut) les valeurs définies explicitement avec les valeurs extraites.

Lorsqu’il n’est pas fourni, le serveur principal de l’authentification Adobe Pass utilise implicitement (par défaut) les valeurs extraites.
obligatoire
Accepter
Type de média accepté par l’application cliente.

S’il est spécifié, il doit s’agir d’application/json.
facultatif
User-Agent
Agent utilisateur de l’application cliente.
facultatif

Réponse response

Succès success

En-têtes
Etat
201
obligatoire
Content-Type
application/json
obligatoire
Corps

Objet JSON possédant les attributs suivants :

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
Attribut
id Identifiant opaque pouvant être utilisé pour le suivi de l’activité des utilisateurs et utilisatrices. obligatoire
access_token Valeur du jeton d’accès que l’application cliente doit utiliser pour l’en-tête Autorisation . obligatoire
created_at Heure en millisecondes à laquelle le jeton d’accès a été émis. obligatoire
expires_in Délai en secondes avant l’expiration du jeton d’accès. obligatoire
token_type Type de jeton (par exemple, « porteur »). obligatoire
obligatoire

Erreur error

En-têtes
Etat
400
obligatoire
Content-Type
application/json
obligatoire
Corps
erreur

Les valeurs possibles sont les suivantes :

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
Valeur
invalid_request

La requête n’est pas valide pour l’une des raisons suivantes :

  • Il manque un paramètre obligatoire à la requête.
  • La requête inclut une valeur de paramètre non prise en charge (autre que le type d’octroi).
  • La requête répète un paramètre.
  • La requête comprend plusieurs informations d’identification.
  • La requête utilise plusieurs mécanismes pour authentifier le client.
  • La requête est incorrecte.
invalid_client Les informations d’identification du client ne sont pas valides. Le client doit obtenir de nouvelles informations d’identification du client et réessayer. Pour plus d’informations, consultez la documentation de l’API Récupération des informations d’identification du client .
authorized_client Le type d'octroi utilisé n'est pas valide.
obligatoire

Exemples samples

Récupérer le jeton d’accès samples-retrieve-access-token

Requête
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
Réponse - Succès
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": 1752148106221,
  "expires_in": 21600,
  "token_type": "bearer"
}
Réponse - Erreur
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