- 接口说明
通过用户授权登录获取的User-Token有效期默认是3个月,过期后需要用户重新授权才能获得新的User-Token。本步骤可以实现授权自动续期,避免要求用户再次授权的操作,提升用户体验。
- 请求地址
请求方式:GET
请求地址:http://api.hisiphp.com/oauth/token
- 请求参数
| 参数 | 是否必须 | 说明 |
| app_id | 是 | |
| grant_type | 是 | 固定值:refresh_token |
| timestamp | 是 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" |
| signature | 是 | 请求参数签名,点此查看签名算法 |
| refresh_token | 是 | 在获取授权登录时返回的refresh_token |
- 成功返回示例
{
"code": 200,
"message": "success",
"data": {
"user_token": "28C52ACF66BA91B0FD8E157F15D6747F",
"refresh_token": "24V62ACF66BA91B0FD8E157F15DDF4GH",
"expires_in": "7776000"
}
}| 参数 | 说明 |
| code | 状态码(200 正常) |
| message | 结果说明,正常返回suceess |
| data | 数据结果 |
| └ user_token | 获取到接口调用的凭证 |
| └ expires_in | 凭证有效时间,单位:秒 |
| └ refresh_token | 在授权自动续期步骤中,获取新的Access-Token时需要提供的参数 |
- 失败返回示例
{
"code": 401,
"message": "Request timed out!"
}| 参数 | 说明 |
| code | 状态码 |
| message | 返回失败原因 |