DocumentationAdobe PassAuthentification Adobe Pass

Récupération des informations d’identification client retrieve-client-credentials

Last update: Fri Dec 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
Le contenu de cette page est fourni à titre d’information uniquement. L’utilisation de cette API nécessite une licence actuelle de Adobe. Aucune utilisation non autorisée n’est autorisée.
IMPORTANT
L’implémentation de l’API d’enregistrement de client dynamique est limitée par la documentation Mécanisme de limitation .

Requête request

HTTP
path
/o/client/register
method
POST
Paramètres du corps
software_statement
L’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 du client dynamique .
required
redirect_uri
L’URI de redirection associé à l’emplacement où navigue l’agent utilisateur une fois le flux d’authentification terminé.
facultatif
En-têtes
Content-Type
Type de média accepté pour les ressources envoyées.

Il doit s’agir de application/json.
required
X-Device-Info
La génération de la payload d’informations sur l’appareil est décrite dans la documentation X-Device-Info.

Il est vivement recommandé de toujours l’utiliser lorsque la plate-forme d’appareil de l’application autorise la spécification explicite de valeurs valides.

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

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

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

Réponse response

Succès success

En-têtes
Etat
201
required
Content-Type
application/json
required
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. required
client_secret Chaîne secrète de l’application cliente. required
client_id_issue_at Heure à laquelle l’identifiant de l’application cliente a été émis. required
redirect_uris Tableau de chaînes URI de redirection que l’application cliente peut utiliser dans les flux basés sur la redirection. required
grant_types Chaînes de type d’octroi que la demande client peut utiliser pour le point de terminaison du jeton client. required
portées Chaînes de portée définissant les API d’authentification Adobe Pass que l’application cliente peut utiliser. required
required

Erreur error

En-têtes
Etat
400
required
Content-Type
application/json
required
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 demande n’est pas valide pour l’une des raisons suivantes :

  • Un paramètre requis n’est pas associé à 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 pour l’URI de redirection non valide.
invalid_software_statement La requête inclut une valeur pour l’instruction logicielle non valide.
unapproved_software_statement La requête inclut une valeur pour l’instruction logicielle qui n’est pas approuvée pour l’utilisation par le serveur d’authentification Adobe Pass.
required

Exemples samples

Récupération des informations d’identification 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