# 设备认证

# 功能说明

获取或刷新请求token

# 请求uri

/xwopenapi/authdevice

# 请求类型

websocket

# 请求参数

接口请求内容需要按照公共参数中的websocket请求格式传入,其中content字段为以下结构json序列化base64编码结果

字段 类型 必填 描述
secret string 个人开发者使用secret认证的设备必填
app_uin int 产品ID,厂商设备必填
sn string 设备序列化,厂商设备必填
license string 设备证书,厂商设备必填
pid int 兼容SDK设备,一般不要填写

# 请求示例

# 个人开发者设备:

{
  "secret": "xxxx"
 }

# 厂商设备:

{
	"app_uin":12,
	"sn": "ABC1234567890",
	"license":"xxx"
}

# 返回参数

接口返回参数遵循公共参数中的websocket响应格式 接口返回的content.response内容base64解码后为以下结构:

字段 类型 必填 描述
token string 其他接口的票据,有效期2小时,过期后需重新获取
expire_time int 过期时间戳,单位:秒

# 返回结果示例:

{
	"code": 0,
	"msg": "success",
	"token":"",  // 后续接口的请求令牌
	"expire_time": 1645090971 // 过期时间,秒级时间戳
}

# 错误说明

如果遇到空的结果或者license err错误,可以按照下面步骤检查:

  1. 携带的参数名称、格式、数据类型是否都正常。比如是否把int填成了string。
  2. license需要使用文档中的工具脚本示例的算法生成,和小微官网的sdk对接方式并不通用。
  3. 内测阶段暂时没提供官网配置入口,是否提供appuin和pubkey给小微进行了预注册。