Récupérer les informations d’identification du client retrieve-client-credentials

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/register
méthode
POSTER
Paramètres du corps
software_statement
Instruction logicielle associée à l'application enregistrée, créée et téléchargée à partir du tableau de bord Adobe Pass TVE .

La gestion des applications enregistrées est décrite dans la documentation Présentation de l’enregistrement client dynamique.
obligatoire
redirect_uri
URI de redirection associé à l’emplacement vers lequel l’agent utilisateur accède une fois le flux d’authentification terminé.
facultatif
En-têtes
Content-Type
Type de média accepté pour les ressources en cours d’envoi.

Il doit s’agir de application/json;charset=utf-8.
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 de application/json;charset=utf-8.
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 6-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 25-bgcolor-deebff layout-auto html-authored
Attribut
client_id Chaîne d’identifiant de l’application cliente. obligatoire
client_secret Chaîne secrète de l’application cliente. obligatoire
client_id_issued_at Heure à laquelle l’identifiant de l’application cliente a été émis. obligatoire
redirect_uri Tableau de chaînes URI de redirection que l’application cliente peut utiliser dans les flux basés sur la redirection. obligatoire
grant_types Chaînes de type grant que l’application cliente peut utiliser pour le point d’entrée du jeton client. obligatoire
portées Les chaînes de portée définissant les API d’authentification Adobe Pass que l’application cliente peut utiliser. 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 4-row-2 1-bgcolor-eff2f7 2-bgcolor-eff2f7 3-bgcolor-eff2f7 5-bgcolor-deebff 8-bgcolor-deebff 11-bgcolor-deebff 14-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.
  • La requête répète un paramètre.
  • La requête est incorrecte.
invalid_redirect_uri La requête inclut une valeur non valide pour l’URI de redirection.
invalid_software_statement La requête inclut une valeur non valide pour l’instruction du logiciel.
unapprove_software_statement La requête inclut une valeur pour l’instruction du logiciel qui n’est pas approuvée pour une utilisation par le serveur d’authentification Adobe Pass.
obligatoire

Exemples samples

Récupérer les informations d’identification du client samples-retrieve-client-credentials

Requête
code language-https
POST /o/client/register HTTP/1.1

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

{
    "software_statement": "eyJhbGciOiJSUzI1NiJ9.
        eyJzb2Z0d2FyZV9pZCI6IjROUkIxLTBYWkFCWkk5RTYtNVNNM1IiLCJjbGll
        bnRfbmFtZSI6IkV4YW1wbGUgU3RhdGVtZW50LWJhc2VkIENsaWVudCIsImNs
        aWVudF91cmkiOiJodHRwczovL2NsaWVudC5leGFtcGxlLm5ldC8ifQ.
        GHfL4QNIrQwL18BSRdE595T9jbzqa06R9BT8w409x9oIcKaZo_mt15riEXHa
        zdISUvDIZhtiyNrSHQ8K4TvqWxH6uJgcmoodZdPwmWRIEYbQDLqPNxREtYn0
        5X3AR7ia4FRjQ2ojZjk5fJqJdQ-JcfxyhK-P8BAWBd6I2LLA77IG32xtbhxY
        fHX7VhuU5ProJO8uvu3Ayv4XRhLZJY4yKfmyjiiKiPNe-Ia4SMy_d_QSWxsk
        U5XIQl5Sa2YRPMbDRXttm2TfnZM1xx70DoYi8g6czz-CPGRi4SW_S2RKHIJf
        IjoI3zTJ0Y2oe0_EJAiXbL6OyF9S5tKxDXV8JIndSA",
    "redirect_uri": "adobepass://com.programmer"
 }
Réponse - Succès
code language-https
HTTP/1.1 201 Created

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

{
    "client_id": "s6BhdRkqt3",
    "client_secret": "t7AkePiru4",
    "redirect_uris": [
        "app://com.programmer.adobe#sdasdsadas"
    ],
    "grant_types": [
        "client_credentials"
    ],
    "scopes": [
        "api:client:v2"
    ],
    "client_id_issued_at": 1723227212
}
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