# 功能详情
对设备节点进行控制
# 请求地址和方法
- 请求地址
https://www.sdzhiot.top/api/v3/control/order
- 请求方法
POST
# 参数说明
- 请求头
Content-Type:application/json;charset=UTF-8
- 请求参数
字段名 | 字段类型 | 字段说明 | 是否必须 |
---|---|---|---|
sno | String | 设备号 | Y |
nodeId | String | 节点编号(设备号+两位数索引) | Y |
val | Integer | 开关指令,见下文 | Y |
- 对于控制指令的解释⭐️⭐️⭐️
控制设备的节点类型由sensorType (opens new window)进行标识,目前有3种类型
sensorType | 含义 | 示例 |
---|---|---|
0 | 数值型节点,只需对数值进行展示即可,无须进行控制 | / |
2 | 开关类型,可以下发0(关闭)或1(开启)指令 | |
3 | 点动类型,只能发送1(开启)的指令 | ![]() |
# 样例输入
{
"sno":"22EDDE1C7AA7",
"nodeId":"22EDDE1C7AA701",
"val":1
}
# 返回data字段说明
字段名 | 字段类型 | 字段说明 |
---|---|---|
code | Integer | 错误码 |
msg | String | 返回信息 |
# 样例输出
{
"code": 500,
"data": null,
"msg": "设备离线"
}
# 返回码
返回码 | 返回消息 | 说明 |
---|---|---|
0 | 操作成功 | 请求成功 |
500 | 服务器错误 | 服务端异常 |
10001 | 参数为空或格式不正确 | 参数错误 |
10002 | appKey不存在 | 确认appKey是否正确 |
40001 | 设备不存在或您没有当前设备权限 | 设备不存在或您没有添加该设备 |
40002 | 设备控制参数错误 | val只能为0或1 |