刷新User-Token

更新日期:2018-10-13 12:13:04

- 接口说明

通过用户授权登录获取的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          返回失败原因