三方应用获取租户的access_token
请求说明
请求地址 | https://openapi.wps.cn/oauth2/token |
---|---|
请求方法 | POST |
权限要求 | 无 |
请求头
Header 名称 | 参数类型 | 是否必填 | 说明 |
---|---|---|---|
Content-Type | string | 是 | 使用:application/x-www-form-urlencoded |
请求体(Body)
名称 | 参数类型 | 是否必填 | 说明 |
---|---|---|---|
grant_type | string | 是 | 授权类型,使用:client_credentials |
client_id | string | 是 | 应用 APPID |
client_secret | string | 是 | 应用 APPKEY |
app_ticket | string | 是 | 获取到的 app_ticket,有关 app_ticket 的详细介绍,请参考通用参数 |
company_id | string | 是 | 企业 id |
请求地址示例
[POST] https://openapi.wps.cn/oauth2/token
1
请求体示例
// Content-Type: application/x-www-form-urlencoded
// 数据示例
grant_type=client_credentials&client_id=AK2024*********&client_secret=6*********&app_ticket=Ok**********S&company_id=L*****
1
2
3
4
2
3
4
接口成功响应体
📌请注意: 每个
access_token
的有效时长为2 小时
,若access_token
未过期仍可使用,直到有效期expires_in
截止失效。 在实际开发对接中,应用应当维护access_token
的有效状态,在调接口时优先使用已获取的access_token
,无需且不推荐每次都重新请求获取access_token
。
名称 | 参数类型 | 说明 |
---|---|---|
access_token | string | 授权 token |
expires_in | integer | 有效时长,单位:秒 |
token_type | string | token 类型,一般为 bearer |
接口失败响应体
名称 | 参数类型 | 说明 |
---|---|---|
code | integer | 错误码。非 0 表示失败,参照《状态码说明》 |
msg | string | 错误信息 |
响应体示例
json
// Content-Type: application/json
{
"access_token": "eyJhbGciOiJFUzI1N**********HQ_JoHbcrL4mZK9Xxg",
"expires_in": 7200,
"token_type": "bearer"
}
1
2
3
4
5
6
7
2
3
4
5
6
7