# 刷新令牌

# 目录

# 接口说明

本接口用于token令牌过期时，主动进行刷新操作。

# 接口介绍

该接口为提高用户体验，无需进行重复登录操作，进行无感更新访问权限。

# 接口配置入口

登录氦闪开发者平台 (opens new window)
"接口管理" 》 "平台接口" 》 "模块API" 》 "用户基础服务"
选择 "刷新令牌"
右上角选择开启

提示：此接口是与账号登录进行适配的级联接口，请确保账号登录可以正常使用。

# 接口调用

# 用户登录基本信息

接口地址：https://lb/business-service/api/open/auth/v1/token/refresh
返回格式：json
请求方式：POST
请求示例：

{
  "refresh_token": "eyJ0eXAiOiJKV.eyJpYXQiOjE3.bUgstrmtfEKTA_zRDCSK89SaQ"
}

# 请求头：

参数名称	类型	说明	是否必填
APPID	string	开发者平台分配的应用APPID	是
_t	number	请求时间戳（毫秒级）	是
_s	string	签名信息，用于接口安全验证	是
_n	随机数	随机数	是

# 请求体（json）：

参数名称	类型	说明	是否必填
refresh_token	string	刷新令牌，由登录接口颁发	是

提示：刷新令牌仅有一次使用权限，成功调用刷新接口会颁发新的刷新令牌。

# 响应头：

参数名称	类型	说明	是否必填
connectionid	string	本次请求的唯一标识	是
_t	number	请求时间戳（毫秒级）	是
_s	string	签名信息，用于接口安全验证	是
_n	随机数	随机数（与本次请求的值一致）	是

# 返回参数（json）

参数名称	类型	说明
code	number	返回状态码，200 表示成功，其他表示失败
message	string	返回信息状态描述
data	object	返回信息摘要
info	object	业务信息
token	string	业务接口访问令牌，默认时效1小时
refreshToken	string	刷新令牌，默认时效14天

返回参数示例：

{
    "code": 200,
    "message": "操作成功",
    "data": "登录成功",
    "info": {
        "token": "eyJ0eXAiOiJKV1QiLCJ.eyJpYXQiOjE3N.UfhyIaxgR_KJ9G60es4gE",
        "refreshToken": "eyJ0eXAiOiJKV.eyJpYXQiOjE3.bUgstrmtfEKTA_zRDCSK89SaQ"
    }
}

← 用户登录退出登录 →