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

NombreRequeridoDescripción
grant_typeyesLos 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ódigodependeEl 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_tokendependeEsto 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_idyesEl ID de cliente configurado en Workfront para esta integración personalizada.
client_secretyesSecreto de cliente configurado en Workfront para esta integración personalizada.

Respuesta

NombreTipoDescripción
access_tokenCadenaUn token utilizado para hacer llamadas de API autorizadas en nombre del usuario. Esto debería caducar para evitar llamadas de API no autorizadas.
refresh_tokenCadenaUn token de larga duración que se utiliza para recuperar un nuevo access_token llamando a este método de API.
expires_inlargo(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
}
Página anteriorAutenticación para webhooks de documentos
Página siguienteObtener metadatos para un archivo o una carpeta

Workfront