refreshToken

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

接口信息

URL	https://ws.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://ws.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": ""
}