获取自建应用的租户access_token
请求说明
| 请求地址 | {配置域名}/openapi/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 | 是 | 在HTTPs环境下,可为明文应用 APPKEY;在非HTTPs环境下,为保证client_secret安全传输,需要进行加密处理,可参考《client_secret加密处理说明》 |
请求地址示例
json
[POST] {配置域名}/openapi/oauth2/token请求体示例
json
// Content-Type: application/x-www-form-urlencoded
// 数据示例
grant_type=client_credentials&client_id=AK2024*********&client_secret=6*********接口成功响应体
📌 请注意:
每个access_token的有效时长为 24 小时,若过期,重新获取的access_token的值与原access_token不一致,请注意区分使用;
> 建议应用开发方维护保存好有效期内的access_token,在调接口时优先使用已保存的,不推荐每次调接口都重新请求获取access_token。
| 名称 | 参数类型 | 说明 |
|---|---|---|
| access_token | string | 授权 token |
| expires_in | integer | 授权 token 有效时长,单位:秒 |
| token_type | string | token 类型,一般为 Bearer |
接口失败响应体
| 名称 | 参数类型 | 说明 |
|---|---|---|
| code | integer | 错误码。非 0 表示失败,参照《状态码说明》 |
| msg | string | 错误信息 |
响应体示例
json
// Content-Type: application/json
{
"access_token": "eyJhb******B7Re55MYSo",
"expires_in": 86400,
"token_type": "Bearer"
}