文档
测试

刷新会话(必接)

POST
请求地址/router

接口描述

用于刷新会话的Token。刷新会话成功后accessToken与refreshToken信息不变,会话时间延长30天,需要确保30天内能刷新成功,延长会话有效期

请求地址

环境 服务地址(HTTP/HTTPS)
V2正式环境(推荐) https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key,统一使用V2正式环境的请求地址:https://gw.superboss.cc/router

公共参数

调用任何一个API都必须传入的参数,目前支持的公共参数有:

参数名称 参数类型 是否必须 参数描述
method string API接口名称
appKey string 分配给应用的AppKey
timestamp string 时间戳,时区为GMT+8,例如:2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
format string 响应格式。默认为json格式,可选值:json
version string API协议版本 可选值:1.0
sign_method string 签名的摘要算法(默认 hmac),可选值为:hmac,md5,hmac-sha256。
sign string 签名
session string 授权会话信息 (即access_token,由系统分配)

请求头

参数名
类型
描述
必填
Content-Type
string
multipart/form-data
必填

API接口地址

参数名
类型
描述
必填
method
string
open.token.refresh
必填

请求参数

参数名
类型
描述
必填
默认值
refreshToken
string
用于刷新会话的token
必填

请求示例

示例一:

{ "refreshToken":"string" }

响应参数

参数名
类型
描述
session
object
session
expiresIn
long
到期时间
companyId
long
关联的企业ID
accessToken
string
会话Token
userId
long
关联的用户ID
refreshToken
string
用来刷新会话的Token

响应示例

{ "session": { "expiresIn": long, "companyId": "long", "accessToken": "string", "userId": long, "refreshToken": "string" } }

异常示例

{ "code": "25", "msg": "服务方法(item.single.get:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" }

错误码解释