Pure Bluetooth Device Binding

API Address:/v2/binding/enduserapi/deviceBindingByPureBt

Request Method:POST

Request Data Type:application/json

Response Data Type:*/*

API Description:Pure Bluetooth device binding

Request Example:

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

Request Parameters:

Parameter Name	Parameter Description	Request Type	Required	Data Type	Schema
param	param	body	true	BindDevicePureBtParam	BindDevicePureBtParam
bindingCode	bindingCode, choose one between this and encryptedBindingCode		false	string
capabilitiesBitmask	Device network capabilities: 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		false	integer(int32)
deviceName	Device name		false	string
dk	Device Key		true	string
encryptedBindingCode	Encrypted bindingCode, choose one between this and bindingCode Algorithm: BASE64_ENCODE(AES_128_CBC(PKCS5Padding(bindingcode), key=PS, iv=random))		false	string
encryptedNewBindingSecret	New encrypted bindingSecret Algorithm: BASE64_ENCODE(AES_128_CBC(PKCS5Padding(PK,DK,bindingSecret), key=PS, iv=random)), PKCS5Padding content includes English comma ","		true	string
encryptedOldBindingSecret	Old encrypted bindingSecret Algorithm: BASE64_ENCODE(AES_128_CBC(PKCS5Padding(PK,DK,bindingSecret), key=PS, iv=random)), PKCS5Padding content includes English comma ","		false	string
fid	Family ID		false	string
frid	Room ID		false	string
isCommonDevice	In home mode, whether to add to common device list (added by default)		false	boolean
pk	Product Key		true	string
pwd	pwd		false	string
random	random		true	string
signature	Signature Algorithm: SHA256(pk+dk+bindingCode+pwd+userDomainSecret) If encryptedBindingCode is passed in the interface, use encryptedBindingCode to calculate bindingCode in the algorithm		true	string

Response Status:

Status Code	Description	Schema
200	Pure Bluetooth device binding successful	Registration code response data«Verified»
5032	Token verification failed
5041	No permission
5049	Device already bound
5052	Device not bound
5066	Please enter Product Key
5067	Please enter Device Key
5106	Please enter token
5179	Please enter bindingCode
5213	Incorrect bindingCode format
5229	User domain not authorized for this product
5314	Device query failed in cloud platform
5327	No permission for this product
5333	Device name exceeds length limit
5357	Incorrect pwd format
5358	No product permission
5361	Incorrect DK format
5412	Product binding mode is unique, cannot bind repeatedly
5624	Home mode not enabled
5636	Please enter family ID
5669	Regular user has no permission to bind device
5893	Failed to add common device
6040	Already accepted device sharing
6083	Bound device does not belong to current data center

Response Parameters:

Parameter Name	Parameter Description	Type	Schema
code	Response status code	integer(int32)	integer(int32)
data	Response data	Verified	Verified
verified	Binding authentication: 0-Not verified 1-Verified	string(byte)
extMsg	Extended message	string
msg	Response message	string

Response Example:

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