该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(不支持的设备类型)