获取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