智慧硬件开发
智慧硬件开发
硬件直连接入
设备接入
接口调用
设备注册网络
设备注册网络
最后更新:2022/09/16

设备联网后调用,发起注册请求。

请求包体:

{
   "cmd":"register",
   "headers":
	{
		"req_id":"xxxxx"
	},
	"body":
	{
		"device_signature":"xxxxx",
		"nonce":123451,
		"timestamp":1231231,
		"sn":"xxxxx",
		"net_info":
		{
			"wifi_name":"wifi111",
			"mac_address":"08:00:20:0A:8C:6D"
		}
	}
}

参数说明:

参数名是否必须类型描述
req_idString请求的id,自行保证不会重复即可
device_signatureString(40)设备签名,sha1(sort(sn、SecretNo、timestamp、nonce, “register”))。sort的含义是将参数值按照字母字典排序,然后从小到大拼接成一个字符串。SecretNo是由企业微信为每个设备生成的密钥,供应商可将其固化到设备上。如果设备生产线不方便分别烧录SecretNo,可以统一烧录seedSecretNo,首次联网时通过换取SecretNo接口获取。本接口计算签名时,需要把字符串常量”register”参与到计算之中,区别二维码的签名。
snString设备序列号
timestampUint32时间戳, 5分钟有效期
nonceUint64随机数
net_infomsgwifi_name, mac_address

 

返回结果:

{
  	"headers": {
      		"req_id" : "xxxx"
  	},
	"body":
	{
		"active_code":"xxxxxx"
	},
  	"errcode": 0,
  	"errmsg": "ok"
}

参数说明:

参数名描述
req_id透传请求的req_id
errcode错误码
errmsg错误码描述
active_code激活码,长期有效
上一篇获取服务器时间
下一篇设备激活
    本节内容
硬件直连接入
更新日志
联系我们