获取设备线圈规则
接口描述
根据设备序列号获取设备的线圈规则信息。
注意：当前仅支持场内设备的线圈规则查询。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 66 |
HTTPS |
GET |
/openapi/v1/stp/user/devices/:sn/rules |
PATH参数
| 参数 |
类型 |
必填 |
说明 |
| sn |
string |
是 |
PATH中的:sn需要替换为具体的设备序列号 |
URL参数
| 参数 |
类型 |
必填 |
说明 |
| accesskey_id |
string |
是 |
参见签名认证 |
| expires |
int |
是 |
参见签名认证 |
| signature |
string |
是 |
参见签名认证 |
请求示例
GET https://open.vzicloud.com/openapi/v1/stp/user/devices/12345678-87654321/rules?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
返回说明
返回参数
| 参数 |
类型 |
说明 |
| rules |
array |
规则列表 |
| + rule_area |
struct |
规则区域 |
| ++ points |
array |
区域坐标点数组 |
| +++ x |
int |
X坐标 |
| +++ y |
int |
Y坐标 |
| ++ point_num |
int |
坐标点数量 |
| + rule_name |
string |
规则名称 |
注：返回参数里可能还包含其他信息但未在上面的表格内列出，请勿使用！
返回示例
{
"rules": [
{
"rule_area": {
"points": [
{ "y": 11984, "x": 2398 },
{ "y": 11984, "x": 13985 },
{ "y": 14007, "x": 15977 },
{ "y": 14007, "x": 406 }
],
"point_num": 4
},
"rule_name": "虚拟线圈"
},
{
"rule_area": {
"points": [
{ "y": 2376, "x": 1285 },
{ "y": 2376, "x": 15056 },
{ "y": 15928, "x": 16148 },
{ "y": 15928, "x": 214 }
],
"point_num": 4
},
"rule_name": "识别区域"
}
]
}