Skip to content

纯蓝牙设备绑定

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

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

纯蓝牙设备绑定

请求示例:

javascript
{
  "bindingCode": "",
  "capabilitiesBitmask": 0,
  "deviceName": "",
  "dk": "",
  "encryptedBindingCode": "",
  "encryptedNewBindingSecret": "",
  "encryptedOldBindingSecret": "",
  "fid": "",
  "frid": "",
  "isCommonDevice": true,
  "pk": "",
  "pwd": "",
  "random": "",
  "signature": ""
}

请求参数:

参数名称参数说明请求类型是否必须数据类型schema
paramparambodytrueBindDevicePureBtParamBindDevicePureBtParam
  bindingCodebindingCode,和 encryptedBindingCode 二选一falsestring
  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
falseinteger(int32)
  deviceName设备名称falsestring
  dkDevice Keytruestring
  encryptedBindingCode加密的 bindingCode,和 bindingCode 二选一
算法:BASE64_ENCODE(AES_128_CBC(PKCS5Padding(bindingcode), key=PS, iv=random))
falsestring
  encryptedNewBindingSecret新的加密 bindingSecret
算法:BASE64_ENCODE(AES_128_CBC(PKCS5Padding(PK,DK,bindingSecret), key=PS, iv=random)) ,PKCS5Padding 的内容包括英文逗号","
truestring
  encryptedOldBindingSecret旧的加密 bindingSecret
算法:BASE64_ENCODE(AES_128_CBC(PKCS5Padding(PK,DK,bindingSecret), key=PS, iv=random)),PKCS5Padding 的内容包括英文逗号","
falsestring
  fid家庭fidfalsestring
  frid房间idfalsestring
  isCommonDevice家居模式下,是否添加到常用设备列表(默认添加)falseboolean
  pkProduct Keytruestring
  pwdpwdfalsestring
  randomrandomtruestring
  signature签名
算法:SHA256(pk+dk+bindingCode+pwd+userDomainSecret)
如果接口中传入了 encryptedBindingCode,算法中的 bindingCode 使用 encryptedBindingCode 进行计算
truestring

响应状态:

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

响应参数:

参数名称参数说明类型schema
code响应状态码integer(int32)integer(int32)
data响应数据VerifiedVerified
  verified绑定认证:0-未认证 1-已认证string(byte)
extMsg扩展消息string
msg响应消息string

响应示例:

javascript
{
	"code": 0,
	"data": {
		"verified": ""
	},
	"extMsg": "",
	"msg": ""
}