Home Explore Help
Register Sign In
persagy
/
persagy-dmp-server-doc
8
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: 87525b1e8e
Branches Tags
persagy-dmp-...
/
docs
/
iot
/
iot.md

iot.md 107 KB
History Raw

iot服务接口

采集相关的接口调用iot-collect服务；

控制相关的接口调用iot-control服务；

控制和采集的实时业务（不查询历史数据的，如能耗、分精度）也可以调用iot-project服务；

[TOC]

能耗

批量查询分项能耗

接口地址:/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

响应参数:

暂无

响应示例:

分精度

查询公式的分精度

接口地址:/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

响应示例: