开关阀门:[DeviceValveManual]

基本信息

  • 接口地址：/gateway/api/v2sign/Device/DeviceValveManual

  • 请求方式：Post

  • 请求类型：application/json

请求参数(Body)

  1. {
  2.     "apiID": {
  3.         "是否必传": true,
  4.         "参数类型": "string",
  5.         "描述": "系统分配的应用授权访问ID",
  6.         "可空类型": false
  7.     },
  8.     "timestamp": {
  9.         "是否必传": true,
  10.         "参数类型": "int64",
  11.         "描述": "UTC时间戳,到毫秒,必须 30秒内",
  12.         "可空类型": false
  13.     },
  14.     "requestId": {
  15.         "是否必传": true,
  16.         "参数类型": "string",
  17.         "描述": "请求id",
  18.         "可空类型": false
  19.     },
  20.     "deviceUid": {
  21.         "是否必传": true,
  22.         "参数类型": "string",
  23.         "描述": "设备唯一ID",
  24.         "可空类型": false
  25.     },
  26.     "dataSign": {
  27.         "是否必传": true,
  28.         "参数类型": "string",
  29.         "描述": "数据签名,签名md5 (ApiID + DeviceUid + RequestId + Timestamp + secretKey) 示例：32位大写",
  30.         "可空类型": false
  31.     },
  32.     "data": {
  33.         "是否必传": true,
  34.         "参数类型": {
  35.             "deviceSwitch": {
  36.                 "是否必传": true,
  37.                 "参数类型": "int32",
  38.                 "描述": "开关状态：0 关，1开",
  39.                 "可空类型": false
  40.             },
  41.             "runTimes": {
  42.                 "是否必传": true,
  43.                 "参数类型": "int32",
  44.                 "描述": "打开时长，仅对 DeviceSwitch = 1 有效， 0 表示不限制",
  45.                 "可空类型": false
  46.             }
  47.         },
  48.         "描述": null,
  49.         "可空类型": false
  50.     }
  51. }

请求示例

  1. {
  2.     "apiID": "string",
  3.     "timestamp": 0,
  4.     "requestId": "string",
  5.     "deviceUid": "string",
  6.     "dataSign": "string",
  7.     "data": {
  8.         "deviceSwitch": 0,
  9.         "runTimes": 0
  10.     }
  11. }

返回参数

  1. {
  2.     "success": {
  3.         "参数类型": "boolean",
  4.         "描述": "操作是否成功",
  5.         "可空类型": false
  6.     },
  7.     "message": {
  8.         "参数类型": "string",
  9.         "描述": "消息",
  10.         "可空类型": true
  11.     },
  12.     "messageId": {
  13.         "参数类型": "int32",
  14.         "描述": "消息ID：1-成功，0-默认错误，其她为自定义错误",
  15.         "可空类型": false
  16.     }
  17. }

返回示例

  1. {
  2.     "success": false,
  3.     "message": "string",
  4.     "messageId": 0
  5. }