Skip to content

使用SN绑定设备

接口地址:/v2/binding/enduserapi/bindDeviceSn

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

使用 SN 绑定设备

请求参数:

参数名称参数说明请求类型是否必须数据类型schema
pkProduct Keyquerytruestring
sn设备SNquerytruestring
capabilitiesBitmask设备联网能力:
1-WAN
2-LAN(WiFi)
3-LAN(WiFi)+WAN
4-BLE
5-WAN+BLE
6-LAN(WiFi)+BLE
7-WAN+LAN(WiFi)+BLE
8-Matter
9-WAN+Matter
10-LAN(WiFi)+Matter
11-LAN(WiFi)+WAN+Matter
12-BLE+Matter
13-WAN+BLE+Matter
14-LAN(WiFi)+BLE+Matter
15-WAN+LAN(WiFi)+BLE+Matter
queryfalseinteger(int32)
deviceName设备名称queryfalsestring
fid家庭fidqueryfalsestring
frid房间idqueryfalsestring
isCommonDevice家居模式下,是否添加到常用设备列表(默认添加)queryfalseboolean

响应状态:

状态码说明schema
200使用 SN 绑定设备成功返回注册码响应数据«绑定»
5009设备验证失败
5032token 验证失败
5041没有权限
5048设备绑定失败
5049设备已绑定
5052设备未绑定
5066请输入Product Key
5067请输入Device Key
5088请输入设备SN
5089设备SN请求失败
5090请求的设备SN无效
5093非正常用户域
5106请输入token
5229用户域未授权此产品
5314云平台中设备查询失败
5327没有此产品的权限
5333设备名称超出长度限制
5361dk格式不正确
5412产品绑定模式为唯一模式,不能重复绑定
5553产品或设备不存在
5624未启用家居模式
5636请输入家庭ID
5669普通用户没有权限绑定设备
5893添加常用设备失败
6040已接受该设备分享
6083绑定的设备不属于当前数据中心

响应参数:

参数名称参数说明类型schema
code响应状态码integer(int32)integer(int32)
data响应数据绑定绑定
  authKeyAuthKeystring
  dkDevice Keystring
  moduleType设备型号string
  pkProduct Keystring
extMsg扩展消息string
msg响应消息string

响应示例:

javascript
{
	"code": 0,
	"data": {
		"authKey": "",
		"dk": "",
		"moduleType": "",
		"pk": ""
	},
	"extMsg": "",
	"msg": ""
}