refreshToken

更新访问令牌

通过 API 更新访问令牌，该接口用于安全续期访问凭证。

接口信息

URL	https://api.xxx.com/auth/refreshToken
请求方式	POST

请求参数

Body

字段名称	类型	是否必选	说明
accessKeyId	String	是	APP访问密钥ID
refreshToken	String	是	刷新令牌
botId	String	否	设备唯一标识 （获取方式）。botId与vendorId二者必选其一
vendorId	String	否	厂商唯一标识 （获取方式）。botId与vendorId二者必选其一

vendorId使用场景

新设备配网后，设备自动注册平台，获取设备唯一标识（botId）

botId使用场景

设备已注册，使用设备botId获取访问授权，调用语音、文本对话等API服务

请求示例

curl --location 'https://api.xxx.com/auth/refreshToken' \
--header 'Content-Type: application/json' \
--data '{
  "accessKeyId": "xxxx",
  "refreshToken": "adasdfjklji1752==",
  "botId": "c22065edb"
}'

注意：参数botId与vendorId同时存在时，优先使用botId生成授权令牌

响应参数

Body

字段名称	类型	是否必选	说明
accessToken	String	必选	用户访问令牌
expireIn	Integer	必选	访问令牌过期时间（秒）,有效期2小时，失效后重新生成或使用refreshToken生成新accessToken
code	Integer	必选	状态码
msg	String	必选	状态对应信息

响应示例

{
  "accessToken": "aaaaaaazI1NiJ9.bbbbbMHZqcCfG2_JOb.LFhU0QeI1EI9J-GQ6-CjoWvj4q3SdZs",
  "expireIn": 7200,
  "code": 0,
  "msg": ""
}

参考页面

• 获取访问令牌: #/zh-cn/chat/authToken/getToken

• 第三方鉴权: #/zh-cn/chat/authToken/3rd-auth