添加设备实例 - 接口文档 - 企业微信开发者中心

智慧硬件开发服务端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(不支持的设备类型)

回调配置

查询设备绑定信息

本节内容

添加设备实例