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