Documentación Workfront Guía de Workfront

Obtener tokens de OAuth2

Última actualización: 17 de julio de 2024

Temas:

Creado para:

Desarrollador

Obteniendo tokens de OAuth2

Devuelve el token de actualización de OAuth2 y el token de acceso de un usuario autenticado. Se invoca una vez cuando el usuario aprovisiona un proveedor de documentos. Se realizan llamadas posteriores para obtener un token de acceso actualizado.

URL

POST /any/url

La dirección URL es configurable y corresponde al valor URL de extremo de token en la página Configuración de integración personalizada.

Parámetros de consulta

Nombre	Requerido	Descripción
grant_type	yes	Los valores incluyen "authorization_code" o "refresh_token". El valor especificado indica cuál de los dos parámetros se pasará a esta llamada de API: code o refresh_token.
código	depende	El código de autorización se envía a Adobe Workfront justo después de que el usuario haga clic en el botón Conceder. Esto solo es necesario cuando el tipo de concesión es "authorization_code". El código de autorización debe ser de corta duración y normalmente caduca en 10 minutos o menos.
refresh_token	depende	Esto solo es necesario cuando se realizan llamadas subsiguientes para recuperar un nuevo access_token, dado que el access_token anterior ha caducado. Al enviar este valor, establezca el parámetro grant_type en "refresh_token".
client_id	yes	El ID de cliente configurado en Workfront para esta integración personalizada.
client_secret	yes	Secreto de cliente configurado en Workfront para esta integración personalizada.

Respuesta

Nombre	Tipo	Descripción
access_token	Cadena	Un token utilizado para hacer llamadas de API autorizadas en nombre del usuario. Esto debería caducar para evitar llamadas de API no autorizadas.
refresh_token	Cadena	Un token de larga duración que se utiliza para recuperar un nuevo access_token llamando a este método de API.
expires_in	largo	(opcional) Tiempo (en segundos) antes de que access_token caduque, por lo general, 3600.

Ejemplo

POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af

Respuesta

{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}

recommendation-more-help