iot.md 114 KB

iot服务接口

云端接口调用iot-collect服务;

控制和采集的实时接口也可以调用iot-project服务;

[TOC]

websocket

链接地址:ws://IP:websocketport/websocket?projectId=10位项目ID&type=iot

参数说明:

websocket端口是单独的端口,和服务端口不是同一个;

字段 说明
projectId 10位项目ID
type 订阅的数据类型,数值类型iot数据使用iot,其他的数据类型根据情况添加,还可以有text,pointset,message,多个之间使用逗号隔开;
getFullData 是否立即获取一次全量数据,不传默认false

例如:ws://127.0.0.1:8858/websocket?projectId=1101070037&type=iot,pointset&getFullData=true

发送数据订阅:

{
    "getFullData": "true",
    "type": [
        "iot",
        "pointset"
    ],
    "projectId": "1101070037"
}

带信息点订阅获取数据

{
    "getFullData": "true",
    "type": [
        "iot",
        "pointset"
    ],
    "points": [
        {
            "meter": "1001",
            "funcid": "11"
        }
    ],
    "projectId": "1101070037"
}

HTTP接口

能耗

批量查询分项能耗

接口地址:/energydata_query_batch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "compress": "true/false",
  "points": [
    {
      "energyModelNodeSign": "EI1001",
      "energyModelSign": "EM01",
      "time_from": "20200101000000",
      "time_period": "15min",
      "time_to": "20200201000000"
    }
  ]
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
ParamBatch_fjd 注意 body true 分项参数 分项参数
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  compress 参数:是否压缩 false string
  points 参数:点位数组 false array 分项点位参数
    energyModelNodeSign 分项编号 false string
    energyModelSign 模型编号 false string
    time_from 开始时间 false string
    time_period 精度 false string
    time_to 结束时间 false string

响应状态:

状态码 说明 schema
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


批量查询仪表能耗分精度

接口地址:/servicedata_query_batch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "compress": "true/false",
  "points": [
    {
      "data_type": "near max min avg",
      "funcid": 10101,
      "meter": "1001",
      "time_from": "20200101000000",
      "time_period": "15min",
      "time_to": "20200201000000"
    }
  ]
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
ParamBatch_fjd 注意 body true 分精度参数 分精度参数
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  compress 参数:是否压缩 false string
  points 参数:点位数组 false array 分精度点位参数
    data_type 表类型 false string
    funcid 功能号 false integer
    meter 仪表编号 false string
    time_from 开始时间 false string
    time_period 精度 false string
    time_to 结束时间 false string

响应状态:

状态码 说明 schema
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


原始数据

查询iot原始数据

接口地址:/listOriginalMonth

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": 1101070037,
  "funcid": 10101,
  "meter": 1001,
  "time_from": "20200101000000",
  "time_to": "20200201000000"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
originalMonthParam 注意:参数和返回值共用此类 body true 原始数据 原始数据
  building 参数:项目编码-10位数字 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  time_from 开始时间 false string
  time_to 结束时间 false string

响应参数:

参数名称 参数说明 类型 schema
code 结果码.00000是成功,其他都是失败 string
data 响应数据 object
message 错误提示信息 string
result 结果标识:成功标识:success,失败标识:fail string
timestamp 响应时间戳 integer(int64) integer(int64)

响应示例:

{
    "code": "",
    "data": {
        "building": 1101070037,
        "datas": [
            {
                "data": 13.14,
                "receivetime": 20201224192034
            }
        ],
        "funcid": 10101,
        "meter": 1001,
        "time_from": "20200101000000",
        "time_to": "20200201000000"
    },
    "message": "",
    "result": "",
    "timestamp": 0
}

批量查询iot原始数据

接口地址:/listOriginalMonthBatch

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

[
  {
    "building": 1101070037,
    "funcid": 10101,
    "meter": 1001,
    "time_from": "20200101000000",
    "time_to": "20200201000000"
  }
]

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
originalMonthParamList 注意:参数和返回值共用此类 body true array 原始数据
  building 参数:项目编码-10位数字 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  time_from 开始时间 false string
  time_to 结束时间 false string

响应参数:

参数名称 参数说明 类型 schema
data 响应数据 object
code 结果码.00000是成功,其他都是失败 string
message 错误提示信息 string
result 结果标识:成功标识:success,失败标识:fail string
timestamp 响应时间戳 integer(int64) integer(int64)

响应示例:

{
    "code": "",
    "data": [
        {
            "building": 1101070037,
            "datas": [
                {
                    "data": 13.14,
                    "receivetime": 20201224192034
                }
            ],
            "funcid": 10101,
            "meter": 1001,
            "time_from": "20200101000000",
            "time_to": "20200201000000"
        }
    ],
    "message": "",
    "result": "",
    "timestamp": 0
}

分精度

查询公式的分精度

接口地址:/expression_query_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "compress": "true/false",
  "expression": "servicedata_10002_10101",
  "time_from": "20200101000000",
  "time_period": "15min",
  "time_to": "20200201000000"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
psp 注意 body true 公式参数 公式参数
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  compress 参数:是否压缩 false string
  expression 公式 false string
  time_from 开始时间 false string
  time_period 精度 false string
  time_to 结束时间 false string

响应状态:

状态码 说明 schema
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


批量查询最小分精度

接口地址:/fjd_period_batch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "compress": "true/false",
  "points": [
    {
      "data_type": "near max min avg",
      "funcid": 10101,
      "meter": "1001",
      "time_from": "20200101000000",
      "time_period": "15min",
      "time_to": "20200201000000"
    }
  ]
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
ParamBatch_fjd 注意 body true 分精度参数 分精度参数
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  compress 参数:是否压缩 false string
  points 参数:点位数组 false array 分精度点位参数
    data_type 表类型 false string
    funcid 功能号 false integer
    meter 仪表编号 false string
    time_from 开始时间 false string
    time_period 精度 false string
    time_to 结束时间 false string

响应状态:

状态码 说明 schema
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


查询分精度

接口地址:/fjd_query/{building}/{meter}/{funcid}/{time_period}/{time_from}/{time_to}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
funcid 功能号 path true string
meter 仪表号 path true string
time_from 开始时间 path true string
time_period 精度 path true string
time_to 结束时间 path true string

响应状态:

状态码 说明 schema
200 OK
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


批量查询分精度

接口地址:/fjd_query_batch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "compress": "true/false",
  "points": [
    {
      "data_type": "near max min avg",
      "funcid": 10101,
      "meter": "1001",
      "time_from": "20200101000000",
      "time_period": "15min",
      "time_to": "20200201000000"
    }
  ]
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
ParamBatch_fjd 注意 body true 分精度参数 分精度参数
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  compress 参数:是否压缩 false string
  points 参数:点位数组 false array 分精度点位参数
    data_type 表类型 false string
    funcid 功能号 false integer
    meter 仪表编号 false string
    time_from 开始时间 false string
    time_period 精度 false string
    time_to 结束时间 false string

响应状态:

状态码 说明 schema
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


插入分精度

接口地址:/insertFjd

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

[
  {
    "building": "",
    "dataFlag": 0,
    "dataTime": "",
    "dataValue": 0,
    "funcid": 0,
    "meter": "",
    "period": "15min"
  }
]

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
fjdDataList 分精度数据 body true array FjdData
  building 10位项目ID false string
  dataFlag 数据标签,默认为0 false integer(int64)
  dataTime 分精度数据时间,格式为:yyyyMMddHHmmss false string
  dataValue 数值 false number(double)
  funcid 功能号 false integer(int64)
  meter 表号 false string
  period 分精度类型:支持1min、5min、15min、1h、1d五种 false string

响应状态:

状态码 说明 schema
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

暂无

响应示例:


异步采集

读取点位

接口地址:/pointread/{building}/{meter}/{funcid}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
funcid 功能号 path true string
meter 仪表号 path true string

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

读取点位

接口地址:/pointread_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "data": 13.14,
  "endtime": "20201224192034",
  "funcid": 10101,
  "meter": "1001",
  "operation": "pointread/pointset",
  "receivetime": "20201224192034",
  "status": "finish:success",
  "virtual": false
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetData 注意:参数和返回值共用此类 body true 点位参数与返回值 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number(double)
  endtime 返回值:操作结束时间 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  operation 参数:操作类型,不需要设置 false string
  receivetime 返回值:操作开始时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
  virtual 参数:是否虚拟点,默认值false false boolean

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

批量读取点位

接口地址:/pointreadbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "endtime": "20201224192034",
      "funcid": 10101,
      "meter": "1001",
      "operation": "pointread/pointset",
      "receivetime": "20201224192034",
      "status": "finish:success",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

{
	"building": "1101070037",
	"points": [
		{
			"building": "1101070037",
			"data": 13.14,
			"endtime": "20201224192034",
			"funcid": 10101,
			"meter": "1001",
			"operation": "pointread/pointset",
			"receivetime": "20201224192034",
			"status": "finish:success",
			"virtual": false
		}
	],
	"receivetime": "20201224192034",
	"status": "finish:success"
}

异步控制

设置点位

接口地址:/pointset/{building}/{meter}/{funcid}/{data}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
data 设定值 path true string
funcid 功能号 path true string
meter 仪表号 path true string

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

设置点位

接口地址:/pointset_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "data": 13.14,
  "endtime": "20201224192034",
  "funcid": 10101,
  "meter": "1001",
  "operation": "pointread/pointset",
  "receivetime": "20201224192034",
  "status": "finish:success",
  "virtual": false
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetData 注意:参数和返回值共用此类 body true 点位参数与返回值 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number(double)
  endtime 返回值:操作结束时间 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  operation 参数:操作类型,不需要设置 false string
  receivetime 返回值:操作开始时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
  virtual 参数:是否虚拟点,默认值false false boolean

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

批量设置点位

接口地址:/pointsetbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "endtime": "20201224192034",
      "funcid": 10101,
      "meter": "1001",
      "operation": "pointread/pointset",
      "receivetime": "20201224192034",
      "status": "finish:success",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

{
	"building": "1101070037",
	"points": [
		{
			"building": "1101070037",
			"data": 13.14,
			"endtime": "20201224192034",
			"funcid": 10101,
			"meter": "1001",
			"operation": "pointread/pointset",
			"receivetime": "20201224192034",
			"status": "finish:success",
			"virtual": false
		}
	],
	"receivetime": "20201224192034",
	"status": "finish:success"
}

批量查询控制结果

接口地址:/pointsetresultbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "funcid": 10101,
      "meter": "1001",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

{
	"building": "1101070037",
	"points": [
		{
			"building": "1101070037",
			"data": 13.14,
			"endtime": "20201224192034",
			"funcid": 10101,
			"meter": "1001",
			"operation": "pointread/pointset",
			"receivetime": "20201224192034",
			"status": "finish:success",
			"virtual": false
		}
	],
	"receivetime": "20201224192034",
	"status": "finish:success"
}

查询采集当前值

查询采集当前值

接口地址:/presentreport/{building}/{meter}/{funcid}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
funcid 功能号 path true string
meter 仪表号 path true string

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

查询采集当前值

接口地址:/presentreport_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "data": 13.14,
  "endtime": "20201224192034",
  "funcid": 10101,
  "meter": "1001",
  "operation": "pointread/pointset",
  "receivetime": "20201224192034",
  "status": "finish:success",
  "virtual": false
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
psp 注意:参数和返回值共用此类 body true 点位参数与返回值 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number(double)
  endtime 返回值:操作结束时间 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  operation 参数:操作类型,不需要设置 false string
  receivetime 返回值:操作开始时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
  virtual 参数:是否虚拟点,默认值false false boolean

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

批量查询采集当前值

接口地址:/presentreportbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "endtime": "20201224192034",
      "funcid": 10101,
      "meter": "1001",
      "operation": "pointread/pointset",
      "receivetime": "20201224192034",
      "status": "finish:success",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

{
	"building": "1101070037",
	"points": [
		{
			"building": "1101070037",
			"data": 13.14,
			"endtime": "20201224192034",
			"funcid": 10101,
			"meter": "1001",
			"operation": "pointread/pointset",
			"receivetime": "20201224192034",
			"status": "finish:success",
			"virtual": false
		}
	],
	"receivetime": "20201224192034",
	"status": "finish:success"
}

查询控制当前值

查询控制当前值

接口地址:/presentset/{building}/{meter}/{funcid}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
funcid 功能号 path true string
meter 仪表号 path true string

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

查询控制当前值

接口地址:/presentset_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "data": 13.14,
  "endtime": "20201224192034",
  "funcid": 10101,
  "meter": "1001",
  "operation": "pointread/pointset",
  "receivetime": "20201224192034",
  "status": "finish:success",
  "virtual": false
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
psp 注意:参数和返回值共用此类 body true 点位参数与返回值 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number(double)
  endtime 返回值:操作结束时间 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  operation 参数:操作类型,不需要设置 false string
  receivetime 返回值:操作开始时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
  virtual 参数:是否虚拟点,默认值false false boolean

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

查询控制当前值

接口地址:/presentsetbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "endtime": "20201224192034",
      "funcid": 10101,
      "meter": "1001",
      "operation": "pointread/pointset",
      "receivetime": "20201224192034",
      "status": "finish:success",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

{
	"building": "1101070037",
	"points": [
		{
			"building": "1101070037",
			"data": 13.14,
			"endtime": "20201224192034",
			"funcid": 10101,
			"meter": "1001",
			"operation": "pointread/pointset",
			"receivetime": "20201224192034",
			"status": "finish:success",
			"virtual": false
		}
	],
	"receivetime": "20201224192034",
	"status": "finish:success"
}

同步采集

读取点位

接口地址:/sync_pointread/{building}/{meter}/{funcid}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
funcid 功能号 path true string
meter 仪表号 path true string

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

读取点位

接口地址:/sync_pointread_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "data": 13.14,
  "endtime": "20201224192034",
  "funcid": 10101,
  "meter": "1001",
  "operation": "pointread/pointset",
  "receivetime": "20201224192034",
  "status": "finish:success",
  "virtual": false
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetData 注意:参数和返回值共用此类 body true 点位参数与返回值 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number(double)
  endtime 返回值:操作结束时间 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  operation 参数:操作类型,不需要设置 false string
  receivetime 返回值:操作开始时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
  virtual 参数:是否虚拟点,默认值false false boolean

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

批量读取点位

接口地址:/sync_pointreadbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "endtime": "20201224192034",
      "funcid": 10101,
      "meter": "1001",
      "operation": "pointread/pointset",
      "receivetime": "20201224192034",
      "status": "finish:success",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

{
	"building": "1101070037",
	"points": [
		{
			"building": "1101070037",
			"data": 13.14,
			"endtime": "20201224192034",
			"funcid": 10101,
			"meter": "1001",
			"operation": "pointread/pointset",
			"receivetime": "20201224192034",
			"status": "finish:success",
			"virtual": false
		}
	],
	"receivetime": "20201224192034",
	"status": "finish:success"
}

同步控制

设置点位

接口地址:/sync_pointset/{building}/{meter}/{funcid}/{data}

请求方式:GET

请求数据类型:application/x-www-form-urlencoded

响应数据类型:*/*

接口描述:

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
building 项目编码-10位数字 path true string
data 设定值 path true string
funcid 功能号 path true string
meter 仪表号 path true string

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

设置点位

接口地址:/sync_pointset_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "data": 13.14,
  "endtime": "20201224192034",
  "funcid": 10101,
  "meter": "1001",
  "operation": "pointread/pointset",
  "receivetime": "20201224192034",
  "status": "finish:success",
  "virtual": false
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetData 注意:参数和返回值共用此类 body true 点位参数与返回值 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number(double)
  endtime 返回值:操作结束时间 false string
  funcid 参数:功能号 false integer(int32)
  meter 参数:仪表编号 false string
  operation 参数:操作类型,不需要设置 false string
  receivetime 返回值:操作开始时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
  virtual 参数:是否虚拟点,默认值false false boolean

响应状态:

状态码 说明 schema
200 OK 点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double) number(double)
endtime 返回值:操作结束时间 string
funcid 参数:功能号 integer(int32) integer(int32)
meter 参数:仪表编号 string
operation 参数:操作类型,不需要设置 string
receivetime 返回值:操作开始时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
virtual 参数:是否虚拟点,默认值false boolean

响应示例:

{
	"building": "1101070037",
	"data": 13.14,
	"endtime": "20201224192034",
	"funcid": 10101,
	"meter": "1001",
	"operation": "pointread/pointset",
	"receivetime": "20201224192034",
	"status": "finish:success",
	"virtual": false
}

批量设置点位

接口地址:/sync_pointsetbatch_post

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "building": "1101070037",
  "points": [
    {
      "building": "1101070037",
      "data": 13.14,
      "endtime": "20201224192034",
      "funcid": 10101,
      "meter": "1001",
      "operation": "pointread/pointset",
      "receivetime": "20201224192034",
      "status": "finish:success",
      "virtual": false
    }
  ],
  "receivetime": "20201224192034",
  "status": "finish:success"
}

请求参数:

参数名称 参数说明 请求类型 是否必须 数据类型 schema
PointSetBatchParam 注意:参数和返回值共用此类 body true 批量点位参数与返回值 批量点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
  points 参数:点位数组 false array 点位参数与返回值
    building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 false string
    data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 false number
    endtime 返回值:操作结束时间 false string
    funcid 参数:功能号 false integer
    meter 参数:仪表编号 false string
    operation 参数:操作类型,不需要设置 false string
    receivetime 返回值:操作开始时间 false string
    status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string
    virtual 参数:是否虚拟点,默认值false false boolean
  receivetime 返回值:操作结束时间 false string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 false string

响应状态:

状态码 说明 schema
200 OK 批量点位参数与返回值
201 Created
401 Unauthorized
403 Forbidden
404 Not Found

响应参数:

参数名称 参数说明 类型 schema
building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
points 参数:点位数组 array 点位参数与返回值
  building 参数:项目编码-10位数字,如果是批量参数的下级则不需要设置 string
  data 操作类型为pointread:该属性是返回值;操作类型为pointset:该属性是参数 number(double)
  endtime 返回值:操作结束时间 string
  funcid 参数:功能号 integer(int32)
  meter 参数:仪表编号 string
  operation 参数:操作类型,不需要设置 string
  receivetime 返回值:操作开始时间 string
  status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string
  virtual 参数:是否虚拟点,默认值false boolean
receivetime 返回值:操作结束时间 string
status 返回值:同步接口返回finish:success是成功,其他都是失败;异步接口可能返回start:sent,或者finish:{除success外的其他字符串}表示失败 string

响应示例:

metadat-web habse接口

**危险操作,非警务动**
指定库检查表
http://localhost:8080/metadata-web/services/Service1_RS/database_check/db_public

普通表查看
http://localhost:8080/metadata-web/services/Service1_RS/table_drop_force/db_public/table1/print
普通表强制删除
http://localhost:8080/metadata-web/services/Service1_RS/table_drop_force/db_public/table1/drop

主表查看
http://localhost:8080/metadata-web/services/Service1_RS/main_table_drop_force/db_public/fjd_1_near_1d/print
主表强制删除
http://localhost:8080/metadata-web/services/Service1_RS/main_table_drop_force/db_public/fjd_1_near_1d/drop

分表查看
http://localhost:8080/metadata-web/services/Service1_RS/child_table_drop_force/db_public/fjd_1_near_1d/200001/print
分表强制删除
http://localhost:8080/metadata-web/services/Service1_RS/child_table_drop_force/db_public/fjd_1_near_1d/200001/drop

删除zk中zillion节点
http://localhost:8080/metadata-web/services/Service1_RS/zk_rmr_zillion

删除zk中compute_engine节点
http://localhost:8080/metadata-web/services/Service1_RS/zk_rmr_compute_engine
修改表坏块
http://localhost:8080/metadata-web/services/Service1_RS/compact_table/db_public/zillion_data_fjd_0_near_15min_202111