Obtenir des jetons OAuth2
Obtenir des jetons OAuth2
Renvoie le jeton d’actualisation et le jeton d’accès OAuth2 d’une personne authentifiée. Cette fonction est invoquée une fois lorsque la personne fournit un fournisseur de documents. Les appels suivants sont effectués pour obtenir un jeton d’accès mis à jour.
URL
POST /any/url
L’URL est configurable et correspond à la valeur de l’URL du point d’entrée de jeton sur la page Configuration de l’intégration personnalisée.
Paramètres de requête
Nom
Requis
Description
grant_type
oui
Les valeurs comprennent « authorization_code » ou « refresh_token ». La valeur spécifiée indique lequel des deux paramètres sera transmis à cet appel API : code ou refresh_token.
code
dépend
Code d’autorisation envoyé à Adobe Workfront lorsque l’utilisateur ou l’utilisatrice a cliqué sur le bouton « Accorder ». Ceci n’est obligatoire que lorsque le type d’octroi est « authorization_code ». Le code d’octroi doit être de courte durée et expire généralement en 10 minutes ou moins.
refresh_token
dépend
Ceci n’est obligatoire que lors d’appels ultérieurs visant à récupérer un nouvel access_token, le précédent access_token ayant expiré. Lors de l’envoi de cette valeur, le paramètre grant_type doit être défini sur « refresh_token ».
client_id
oui
L’ID client configuré dans Workfront pour cette intégration personnalisée.
client_secret
oui
Le secret client configuré dans Workfront pour cette intégration personnalisée.
Réponse
Nom
Type
Description
access_token
Chaîne
Un jeton utilisé pour effectuer des appels API autorisés au nom de la personne. Il doit expirer pour éviter les appels d’API non autorisés.
refresh_token
Chaîne
Un jeton de longue durée utilisé pour récupérer un nouvel access_token en appelant cette méthode d’API.
expires_in
long
(facultatif) Le temps (en secondes) avant l’expiration de l’access_token, généralement 3 600.
Exemple
POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af
Réponse
{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43