文档WorkfrontWorkfront 指南

获取OAuth2标记

2024年7月18日
  • 主题:

创建对象:

  • 开发人员

获取OAuth2令牌

返回经过身份验证的用户的OAuth2刷新令牌和访问令牌。 当用户设置文档提供商时,将调用一次。 随后进行调用以获取更新的访问令牌。

URL

POST/any/url

该URL是可配置的,并且对应于自定义集成设置页面上的令牌端点URL值。

查询参数

名称必填描述
grant_type是值包括“authorization_code”或“refresh_token”。 指定的值指示将传递到此API调用的两个参数中的哪个:code或refresh_token。
代码根据用户单击“Grant”按钮后发送到Adobe Workfront的授权代码。 仅当授权类型为“authorization_code”时才需要此项。 授权码应为短期,通常在10分钟或更短时间内过期。
refresh_token根据仅当进行后续调用以检索新的access_token时,才需要此项,因为之前的access_token已过期。 发送此值时,请将grant_type参数设置为“refresh_token”。
client_id是在Workfront中为此自定义集成配置的客户端ID。
clientsecret是Workfront中为此自定义集成配置的客户端密钥。

响应

名称类型描述
access_token字符串用于代表用户进行授权API调用的令牌。 这应该会终止,以防止未授权的API调用。
refresh_token字符串长效令牌,用于通过调用此API方法检索新的access_token。
expires_in长(可选)access_token过期之前的时间(以秒为单位),通常为3,600。

示例

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

响应

{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43