Documentação Workfront Guia do Workfront

Obter tokens do OAuth2

Última atualização: 17 de julho de 2024

Tópicos:

Criado para:

Desenvolvedor

Obtenção de tokens do OAuth2

Retorna o token de atualização OAuth2 e o token de acesso para um usuário autenticado. Isso é chamado uma vez quando o usuário provisiona um Provedor de documentos. As chamadas subsequentes são feitas para obter um token de acesso atualizado.

URL

POST /any/url

O URL é configurável e corresponde ao valor do URL do endpoint do token na página de configuração da integração personalizada.

Parâmetros de consulta

Nome	Obrigatório	Descrição
grant_type	sim	Os valores incluem "authorization_code" ou "refresh_token". O valor especificado indica qual dos dois parâmetros será passado para esta chamada de API: code ou refresh_token.
código	depende	O código de autorização enviado ao Adobe Workfront logo após o usuário clicar no botão "Conceder". Isso só é necessário quando o tipo de concessão é "authorization_code". O código de autorização deve ter uma vida curta, geralmente expirando em 10 minutos ou menos.
refresh_token	depende	Isso só é necessário ao fazer chamadas subsequentes para recuperar um novo access_token, visto que o access_token anterior expirou. Ao enviar esse valor, defina o parâmetro grant_type como "refresh_token".
client_id	sim	A ID do cliente configurada no Workfront para essa integração personalizada.
client_secret	sim	O Segredo do cliente configurado no Workfront para essa integração personalizada.

Resposta

Nome	Tipo	Descrição
access_token	String	Um token usado para fazer chamadas de API autorizadas em nome do usuário. Isso deve expirar para evitar chamadas de API não autorizadas.
refresh_token	String	Um token de longa duração usado para recuperar um novo access_token chamando esse método de API.
expires_in	long	(opcional) O tempo (em segundos) antes que o access_token expire, geralmente 3.600.

Exemplo

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

Resposta

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

recommendation-more-help