帮助文档

# 设备实时数据配置查询

  • 接口描述

用户可通过本接口获取自己名下指定设备的实时数据配置信息。

  • 请求方法

GET

  • 请求路径
/v1/dev/rtd/config
  • 接口传参说明
参数 含义 数据类型 传参限制 是否必填
currPage 当前页数 字符串 1-3位正整型数 是
perPage 每页条数 字符串 10 / 50 / 100 是
snCode 设备SN码 字符串 纯数字字符串 是
  • 返回值示例

此处仅描述data中包含的数据，外部返回值的含义请参考统一返回值 (opens new window)。

{
  "list": [
    {
      "groupName": "内部地址", // 配置分组名
      "snCode": "20010009", // 设备SN码
      "dataWriteable": 1, // 读写状态 (1-读/写，2-只读，3-只写)
      "sendState": 1,  // 是否已同步到设备 (1-是，0-否)
      "dataName": "60844", // 数据名
      "dataCode": 8382, // 数据编号
      "dataMin": "0", // 最小值
      "dataMax": "65535" // 最大值
    },
    {
      "groupName": "内部地址",
      "snCode": "20010009",
      "dataWriteable": 2,
      "sendState": 1,
      "dataName": "60842",
      "dataCode": 8381,
      "dataMin": "-999999999",
      "dataMax": "999999999"
    }
  ],
  "totalPage": 2,
  "totalSize": 4
}

# 设备实时数据查询

  • 接口描述

用户可通过本接口获取自己名下指定设备的实时数据。

  • 请求方法

GET

  • 请求路径
/v1/dev/rtd/data
  • 接口传参说明
参数 含义 数据类型 传参限制 是否必填
snCode 设备SN码 字符串 纯数字字符串 是
dataCode 实时数据编号（通过实时数据配置查询接口获取；
如有多个编号，以英文逗号分隔）		 字符串 是
  • 返回值示例

以下为返回结果示例。

{
  "meta": {
    "success": true,
	"message": "ok"
  },
  "data": [
    {
      "dataCode": "8382", // 实时数据编号
      "value": "0" // 实时数据当前值
    },
    {
      "dataCode": " 8380",
      "value": null
    }
  ]
}

# 写入实时数据

  • 接口描述

用户可通过本接口编辑指定实时数据编号（可以通过实时数据配置接口获取）的实时数据值。

  • 请求方法

POST

  • 请求路径
/v1/dev/rtd/write
  • 接口传参说明
参数 含义 数据类型 传参限制 是否必填
currPage 当前页数 字符串 1-3位正整型数 是
dataCode 实时数据编号（通过实时数据配置查询接口获取） 字符串 是
value 要写入的实时数据新值 字符串 是
  • 返回值示例

返回如下结果则操作成功。

{
  "meta": {
    "success": true,
    "message": "ok"
  },
  "data": "100001"
}

← 历史数据 →