智慧硬件开发 服务端API 设备管理 接口调用 添加设备实例
添加设备实例

该API用于添加一个设备的实例

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/service/add_device?provider_access_token=PROVIDER_ACCESS_TOKEN

请求包体:

{	
	"model_id":"hwme7a11fc60a668689",
	"device_sn":"WXWK001"  
}

参数说明:

参数是否必须说明
provider_access_token应用提供商的provider_access_token,获取方法参见服务商的凭证
model_id设备的型号id,在服务商管理端添加设备型号之后,可以查看型号id
device_sn硬件序列号,只能包含数字和大小写字母,长度最大为128字节,不可与之前已导入的相同

返回结果:

{
 "errcode" : 0,
 "errmsg" : "ok",
 "device_info" : {
      "model_id" : "hwme7a11fc60a668689",
      "device_sn" : "testdevice001",
      "create_time" : 1540971927,
      "secret_no" : "a4f656e3d2e51566a98bd84751c9xxxx",
      "device_id" : 6618424034010721282,
      "qr_code" : "https://open.work.weixin.qq.com/connect/hardware?hw_code=Jq7BtgRwZ1Sg-xxxxx"
 }
       

参数说明:

参数说明
errcode错误码
errmsg错误码对应的描述
device_info.model_id设备型号id
device_info.device_sn设备sn
create_time设备添加的时间戳
secret_no设备的secret_no
device_id设备的deviceid
qr_code设备的静态二维码内容,注意要用此内容生成二维码


参数说明:
注意,调用该接口前请确保已在管理端添加过设备型号,即保证model_id已经存在;该接口只支持通用设备,非通用设备调用会返回错误码60039(不支持的设备类型)

上一篇
回调配置
下一篇
查询设备绑定信息