# 功能详情

对设备节点进行控制

# 请求地址和方法

  • 请求地址

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