跳至主要内容

电表相关

用户下电表列表​

接口描述​

根据关键字,接入方向,电表类型,以及通选状态,获取当前用户下所有的电表列表

请求方法​

/sol_monitor/ammeter/user/list

请求方式​

GET

请求参数​

名称位置类型必选说明
keyWordquerystring否设备别名/SN/所属电站
communicationStatusquerystring否通讯状态
ammeterDirectionquerystring否接入方向,0:正接,1:反接
pagequerystring是页码
pageSizequerystring是每页个数
ammeterTypequerystring是电表类型,0:光伏表,1:上网表
deviceheaderstring否
localeheaderstring否
serviceModuleheaderstring是服务模块,固定为 BASE
x-access-tokenheaderstring是

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue是否成功
» messagestringtrue响应信息
» codeintegertrue响应码
» resultobjecttrue结果
»» content[object]true电表列表
»»» idintegerfalse电表 ID
»»» brandIdintegerfalse品牌 ID
»»» createTimestringfalse创建时间
»»» namestringfalse型号名称
»»» plantIdintegerfalse电站 ID
»»» ammeterAliasstringfalse电表别名
»»» ammeterSnstringfalse电表 SN
»»» ammeterStatusintegerfalse电表状态,
»»» ammeterEnergynumberfalse当日发电量
»»» ammeterTypeintegerfalse电表类型,0:光伏表,1:光口表,2:计量电表
»»» ammeterDirectionintegerfalse接入方向,0:正接,1:反接
»»» ammeterRateintegerfalse波特率
»»» brandNamestringfalse品牌名称
»»» modelIdintegerfalse型号 ID
»»» dataUpdateTimestringfalse数据更新时间
»»» ammeterCollectorstringfalse关联采集器 SN
»»» ammeterCollectorNamestringfalse关联采集器名称
»»» rdlInitialReadingintegerfalse正向总有功读数
»»» rrcInitialReadingintegerfalse反向总有功读数
»»» rrc1InitialReadingintegerfalse反向尖有功读数
»»» rdl1InitialReadingintegerfalse正向尖有功读数
»»» rrc2InitialReadingintegerfalse反向峰有功读数
»»» rdl2InitialReadingintegerfalse正向峰有功读数
»»» rrc3InitialReadingintegerfalse反向平有功读数
»»» rdl3InitialReadingintegerfalse正向平有功读数
»»» rrc4InitialReadingintegerfalse反向谷有功读数
»»» rdl4InitialReadingintegerfalse正向谷有功读数
»»» accessStatusintegerfalse接入状态,0:未接入,1:已接入
»»» associatedDeviceModeintegerfalse关联设备方式,0:采集器,1:API
»»» calculationStartDatestringfalse计量开始时间
»»» plantNamestringfalse电站名称
»»» postalAddressstringfalse通讯地址
»»» apiIdintegerfalse数据接入 ID
»»» apiNamestringfalseAPI 名称
»»» batteryStatusnumberfalse电池状态,0:电量不足,1:电池健康
»»» batteryVoltagenumberfalse电池电压
»»» keepYearsintegerfalse质保时间-年
»»» keepMonthsintegerfalse质保时间-月
»»» keepDailyintegerfalse质保时间-天
»»» keepStartTimestringfalse质保开始时间
»»» keepEndTimestringfalse质保结束时间
»»» nameRuleintegerfalse命名规则:0:平台规则,1:自定义
»»» forwardPhotosUploadStatusintegerfalse资产图片是否上传,0:未上传,1:已上传
»»» assetsViewStatusnumberfalse资产标记状态,0:未标记,2:已标记
»»» isCalcnumberfalse是否计入电量计算,0:否,1:是
»»» remarkstringfalse备注
»»» deviceImagestringfalse设备图片
»»» hasQuotaintegerfalse是否有额度
»»» powerSupplyTypeintegerfalse供电类型,0:电池供电,1:电源供电
»» totalElementsintegertrue总条数
»» totalPagesintegertrue总页数
» timestampintegertrue时间戳

返回示例​

{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"content": [
{
"id": 17,
"brandId": 1221,
"createTime": "2022-06-10 14:24:38",
"updateTime": "2025-01-24 14:15:06",
"name": "禾金泰DLT645电表",
"isDelete": 0,
"plantId": 37713,
"ammeterAlias": "光伏表03",
"ammeterSn": "91002104",
"ammeterStatus": 0,
"ammeterEnergy": 536,
"ammeterType": 0,
"ammeterDirection": 0,
"ammeterRate": 160,
"brandName": "通用",
"modelId": 4,
"dataSource": "3",
"dataUpdateTime": "2025-01-24 14:00:27",
"ammeterCollector": null,
"ammeterCollectorName": null,
"bindFlag": 0,
"modifyDataTime": "2025-01-24 14:00:27",
"unbindTime": null,
"dataAccessTime": null,
"offLineExceedDay": 0,
"rdlInitialReading": 0,
"rrcInitialReading": 0,
"rrc1InitialReading": 0,
"rdl1InitialReading": 0,
"rrc2InitialReading": 0,
"rdl2InitialReading": 0,
"rrc3InitialReading": 0,
"rdl3InitialReading": 0,
"rrc4InitialReading": 0,
"rdl4InitialReading": 0,
"collectorId": null,
"accessStatus": 1,
"associatedDeviceMode": 1,
"calculationStartDate": "2024-02-22 00:00:00",
"plantName": "苏州太仓连城1.458MWp工商业电站",
"scopeUseId": null,
"scopeUseName": null,
"postalAddress": "1558644440",
"apiId": 108,
"apiName": "禾金泰电表数据接入",
"powerNoChange": 0,
"isShutdown": 0,
"batteryStatus": null,
"batteryVoltage": null,
"keepYears": 4,
"keepMonths": null,
"keepDaily": null,
"keepStartTime": null,
"keepEndTime": null,
"nameRule": 1,
"forwardPhotos": null,
"forwardPhotosUploadStatus": null,
"assetsViewStatus": null,
"areaDivideId": null,
"areaDivideName": null,
"isCalc": null,
"remark": null,
"deviceImage": null,
"virtualAmmeterTimeList": null,
"inverterIdList": null,
"hasQuota": 1,
"powerSupplyType": 1
}
],
"totalElements": 429,
"totalPages": 22
},
"timestamp": 1737700705254
}

电站下电表列表​

接口描述​

根据关键字,接入方向,电表类型,以及通选状态,获取电站下所有的电表列表

请求方法​

/sol_monitor/ammeter/list

请求方式​

GET

请求参数​

名称位置类型必选说明
plantIdqueryinteger是电站ID
keyWordquerystring否设备别名/SN/所属电站
communicationStatusquerystring否通讯状态
ammeterDirectionquerystring否接入方向,0:正接,1:反接
pagequerystring是页码
pageSizequerystring是每页个数
typequerystring是电表类型,0:光伏表,1:上网表
deviceheaderstring否
localeheaderstring否
serviceModuleheaderstring是服务模块,固定为 BASE
x-access-tokenheaderstring是

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue是否成功
» messagestringtrue响应信息
» codeintegertrue响应码
» resultobjecttrue结果
»» content[object]true电表列表
»»» idintegerfalse电表 ID
»»» brandIdintegerfalse品牌 ID
»»» createTimestringfalse创建时间
»»» namestringfalse型号名称
»»» plantIdintegerfalse电站 ID
»»» ammeterAliasstringfalse电表别名
»»» ammeterSnstringfalse电表 SN
»»» ammeterStatusintegerfalse电表状态,
»»» ammeterEnergynumberfalse当日发电量
»»» ammeterTypeintegerfalse电表类型,0:光伏表,1:光口表,2:计量电表
»»» ammeterDirectionintegerfalse接入方向,0:正接,1:反接
»»» ammeterRateintegerfalse波特率
»»» brandNamestringfalse品牌名称
»»» modelIdintegerfalse型号 ID
»»» dataUpdateTimestringfalse数据更新时间
»»» ammeterCollectorstringfalse关联采集器 SN
»»» ammeterCollectorNamestringfalse关联采集器名称
»»» rdlInitialReadingintegerfalse正向总有功读数
»»» rrcInitialReadingintegerfalse反向总有功读数
»»» rrc1InitialReadingintegerfalse反向尖有功读数
»»» rdl1InitialReadingintegerfalse正向尖有功读数
»»» rrc2InitialReadingintegerfalse反向峰有功读数
»»» rdl2InitialReadingintegerfalse正向峰有功读数
»»» rrc3InitialReadingintegerfalse反向平有功读数
»»» rdl3InitialReadingintegerfalse正向平有功读数
»»» rrc4InitialReadingintegerfalse反向谷有功读数
»»» rdl4InitialReadingintegerfalse正向谷有功读数
»»» accessStatusintegerfalse接入状态,0:未接入,1:已接入
»»» associatedDeviceModeintegerfalse关联设备方式,0:采集器,1:API
»»» calculationStartDatestringfalse计量开始时间
»»» plantNamestringfalse电站名称
»»» postalAddressstringfalse通讯地址
»»» apiIdintegerfalse数据接入 ID
»»» apiNamestringfalseAPI 名称
»»» batteryStatusnumberfalse电池状态,0:电量不足,1:电池健康
»»» batteryVoltagenumberfalse电池电压
»»» keepYearsintegerfalse质保时间-年
»»» keepMonthsintegerfalse质保时间-月
»»» keepDailyintegerfalse质保时间-天
»»» keepStartTimestringfalse质保开始时间
»»» keepEndTimestringfalse质保结束时间
»»» nameRuleintegerfalse命名规则:0:平台规则,1:自定义
»»» forwardPhotosUploadStatusintegerfalse资产图片是否上传,0:未上传,1:已上传
»»» assetsViewStatusnumberfalse资产标记状态,0:未标记,2:已标记
»»» isCalcnumberfalse是否计入电量计算,0:否,1:是
»»» remarkstringfalse备注
»»» deviceImagestringfalse设备图片
»»» hasQuotaintegerfalse是否有额度
»»» powerSupplyTypeintegerfalse供电类型,0:电池供电,1:电源供电
»» totalElementsintegertrue总条数
»» totalPagesintegertrue总页数
» timestampintegertrue时间戳

返回示例​

{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"content": [
{
"id": 17,
"brandId": 1221,
"createTime": "2022-06-10 14:24:38",
"updateTime": "2025-01-24 14:15:06",
"name": "禾金泰DLT645电表",
"isDelete": 0,
"plantId": 37713,
"ammeterAlias": "光伏表03",
"ammeterSn": "91002104",
"ammeterStatus": 0,
"ammeterEnergy": 536,
"ammeterType": 0,
"ammeterDirection": 0,
"ammeterRate": 160,
"brandName": "通用",
"modelId": 4,
"dataSource": "3",
"dataUpdateTime": "2025-01-24 14:00:27",
"ammeterCollector": null,
"ammeterCollectorName": null,
"bindFlag": 0,
"modifyDataTime": "2025-01-24 14:00:27",
"unbindTime": null,
"dataAccessTime": null,
"offLineExceedDay": 0,
"rdlInitialReading": 0,
"rrcInitialReading": 0,
"rrc1InitialReading": 0,
"rdl1InitialReading": 0,
"rrc2InitialReading": 0,
"rdl2InitialReading": 0,
"rrc3InitialReading": 0,
"rdl3InitialReading": 0,
"rrc4InitialReading": 0,
"rdl4InitialReading": 0,
"collectorId": null,
"accessStatus": 1,
"associatedDeviceMode": 1,
"calculationStartDate": "2024-02-22 00:00:00",
"plantName": "苏州太仓连城1.458MWp工商业电站",
"scopeUseId": null,
"scopeUseName": null,
"postalAddress": "1558644440",
"apiId": 108,
"apiName": "禾金泰电表数据接入",
"powerNoChange": 0,
"isShutdown": 0,
"batteryStatus": null,
"batteryVoltage": null,
"keepYears": 4,
"keepMonths": null,
"keepDaily": null,
"keepStartTime": null,
"keepEndTime": null,
"nameRule": 1,
"forwardPhotos": null,
"forwardPhotosUploadStatus": null,
"assetsViewStatus": null,
"areaDivideId": null,
"areaDivideName": null,
"isCalc": null,
"remark": null,
"deviceImage": null,
"virtualAmmeterTimeList": null,
"inverterIdList": null,
"hasQuota": 1,
"powerSupplyType": 1
}
],
"totalElements": 429,
"totalPages": 22
},
"timestamp": 1737700705254
}

电表详情​

接口描述​

根据电表 ID,获取电表的详细信息

请求方法​

/sol_monitor/ammeter/details

请求方式​

GET

请求参数​

名称位置类型必选说明
idquerystring是电表 ID
deviceheaderstring否
localeheaderstring否
x-access-tokenheaderstring是

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue是否成功
» messagestringtrue响应信息
» codeintegertrue响应码
» resultobjecttrue电表详情
»» idintegerfalse电表 ID
»» brandIdintegerfalse品牌 ID
»» createTimestringfalse创建时间
»» namestringfalse型号名称
»» plantIdintegerfalse电站 ID
»» ammeterAliasstringfalse电表别名
»» ammeterSnstringfalse电表 SN
»» ammeterStatusintegerfalse电表状态,
»» ammeterEnergynumberfalse当日发电量
»» ammeterTypeintegerfalse电表类型,0:光伏表,1:光口表,2:计量电表
»» ammeterDirectionintegerfalse接入方向,0:正接,1:反接
»» ammeterRateintegerfalse波特率
»» brandNamestringfalse品牌名称
»» modelIdintegerfalse型号 ID
»» dataUpdateTimestringfalse数据更新时间
»» ammeterCollectorstringfalse关联采集器 SN
»» ammeterCollectorNamestringfalse关联采集器名称
»» rdlInitialReadingintegerfalse正向总有功读数
»» rrcInitialReadingintegerfalse反向总有功读数
»» rrc1InitialReadingintegerfalse反向尖有功读数
»» rdl1InitialReadingintegerfalse正向尖有功读数
»» rrc2InitialReadingintegerfalse反向峰有功读数
»» rdl2InitialReadingintegerfalse正向峰有功读数
»» rrc3InitialReadingintegerfalse反向平有功读数
»» rdl3InitialReadingintegerfalse正向平有功读数
»» rrc4InitialReadingintegerfalse反向谷有功读数
»» rdl4InitialReadingintegerfalse正向谷有功读数
»» accessStatusintegerfalse接入状态,0:未接入,1:已接入
»» associatedDeviceModeintegerfalse关联设备方式,0:采集器,1:API
»» calculationStartDatestringfalse计量开始时间
»» plantNamestringfalse电站名称
»» postalAddressstringfalse通讯地址
»» apiIdintegerfalse数据接入 ID
»» apiNamestringfalseAPI 名称
»» batteryStatusnumberfalse电池状态,0:电量不足,1:电池健康
»» batteryVoltagenumberfalse电池电压
»» keepYearsintegerfalse质保时间-年
»» keepMonthsintegerfalse质保时间-月
»» keepDailyintegerfalse质保时间-天
»» keepStartTimestringfalse质保开始时间
»» keepEndTimestringfalse质保结束时间
»» nameRuleintegerfalse命名规则:0:平台规则,1:自定义
»» forwardPhotosUploadStatusintegerfalse资产图片是否上传,0:未上传,1:已上传
»» assetsViewStatusnumberfalse资产标记状态,0:未标记,2:已标记
»» isCalcnumberfalse是否计入电量计算,0:否,1:是
»» remarkstringfalse备注
»» deviceImagestringfalse设备图片
»» hasQuotaintegerfalse是否有额度
»» powerSupplyTypeintegerfalse供电类型,0:电池供电,1:电源供电
» timestampintegertrue时间戳

返回示例​

{
"success": true,
"message": "string",
"code": 0,
"result": {
"id": 0,
"brandId": 0,
"createTime": "string",
"name": "string",
"plantId": 0,
"ammeterAlias": "string",
"ammeterSn": "string",
"ammeterStatus": 0,
"ammeterEnergy": 0,
"ammeterType": 0,
"ammeterDirection": 0,
"ammeterRate": 0,
"brandName": "string",
"modelId": 0,
"dataUpdateTime": "string",
"ammeterCollector": "string",
"ammeterCollectorName": "string",
"rdlInitialReading": 0,
"rrcInitialReading": 0,
"rrc1InitialReading": 0,
"rdl1InitialReading": 0,
"rrc2InitialReading": 0,
"rdl2InitialReading": 0,
"rrc3InitialReading": 0,
"rdl3InitialReading": 0,
"rrc4InitialReading": 0,
"rdl4InitialReading": 0,
"accessStatus": 0,
"associatedDeviceMode": 0,
"calculationStartDate": "string",
"plantName": "string",
"postalAddress": "string",
"apiId": 0,
"apiName": "string",
"batteryStatus": 0,
"batteryVoltage": 0,
"keepYears": 0,
"keepMonths": 0,
"keepDaily": 0,
"keepStartTime": "string",
"keepEndTime": "string",
"nameRule": 0,
"forwardPhotosUploadStatus": 0,
"assetsViewStatus": 0,
"isCalc": 0,
"remark": "string",
"deviceImage": "string",
"hasQuota": 0,
"powerSupplyType": 0
},
"timestamp": 0
}

电表设备数据​

接口描述​

根据电表 ID,日期,以及类型(日,月,年,总)获取电表相关读数

请求方法​

/sol_monitor/ammeter/detailsData

请求方式​

GET

请求参数​

名称位置类型必选说明
ammeterIdquerystring是电表 ID
datequerystring是日期
typequerystring是日期类型,DAY:日,MONTH:月,YEAR:年,TILL_NOW:总
deviceheaderstring否
localeheaderstring否
x-access-tokenheaderstring是

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue是否成功
» messagestringtrue响应信息
» codeintegertrue响应 code
» resultobjecttrue结果
»» ammeterDataobjecttrue电表数据
»»» ammeterRdl0numbertrue电表正向读数
»»» ammeterRdl1integertrue正向尖有功读数
»»» ammeterRdl2numbertrue正向尖峰功读数
»»» ammeterRdl3numbertrue正向尖平功读数
»»» ammeterRdl4numbertrue正向尖谷功读数
»»» ammeterRrc0numbertrue电表反向读数
»»» ammeterRrc1integertrue反向尖有功读数
»»» ammeterRrc2numbertrue反向峰有功读数
»»» ammeterRrc3numbertrue反向平有功读数
»»» ammeterRrc4numbertrue反向谷有功读数
»» deliveredValuenumbertrue(日/月/年/总)正向读数
»» receivedValueintegertrue(日/月/年/总)反向读数
»» deliveredTotalnumbertrue正向有功电量
»» receivedTotalnumbertrue反向有功电量
»» deliveredSharpValuenumbertrue尖发电量
»» deliveredPeaksValuenumbertrue峰发电量
»» deliveredFlatValuenumbertrue平发电量
»» deliveredValleysValuenumbertrue谷发电量
» timestampintegertrue时间戳

返回示例​

{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"ammeterData": {
"ammeterRdl0": 41,
"ammeterRdl1": 65,
"ammeterRdl2": 48,
"ammeterRdl3": 28,
"ammeterRdl4": 45,
"ammeterRrc0": 68,
"ammeterRrc1": 88,
"ammeterRrc2": 94,
"ammeterRrc3": 6,
"ammeterRrc4": 91
},
"deliveredValue": 24,
"receivedValue": 26,
"deliveredTotal": 46,
"receivedTotal": 4,
"deliveredSharpValue": 14,
"deliveredPeaksValue": 45,
"deliveredFlatValue": 36,
"deliveredValleysValue": 38
},
"timestamp": 1688337735343
}

电表数据通用接口​

接口描述​

根据电表 ID,日期,以及数据枚举,获取对应枚举的数据,可以一次性获取多个数据

请求方法​

/sol_monitor/iot/meter

请求方式​

POST

请求参数​

名称位置类型必选说明
deviceheaderstring否
localeheaderstring否
x-access-tokenheaderstring是
bodybodyobject是
» datebodystring是日期
» meterIdbodyinteger是电表 ID
» keyListbody[string]是枚举列表

枚举值​

属性值说明
» keyListDELIVERED_ARR正向日发电量
» keyListDELIVERED_ARR_MONTH正向日发电量(月)
» keyListDELIVERED_ARR_YEAR正向日发电量(年)
» keyListDELIVERED_ARR_TILL_NOW正向日发电量(至今)
» keyListRECEIVED_ARR反向日发电量
» keyListRECEIVED_ARR_MONTH反向日发电量(月)
» keyListRECEIVED_ARR_YEAR反向日发电量(年)
» keyListRECEIVED_ARR_TILL_NOW反向日发电量(至今)
» keyListALL_DELIVERED_ARR正向有功总(总正向发电量)
» keyListALL_DELIVERED_ARR_MONTH正向有功总(总正向发电量 - 月)
» keyListALL_DELIVERED_ARR_YEAR正向有功总(总正向发电量 - 年)
» keyListALL_DELIVERED_ARR_TILL_NOW正向有功总(总正向发电量 - 至今)
» keyListALL_RECEIVED_ARR反向有功总(总反向发电量)
» keyListALL_RECEIVED_ARR_MONTH反向有功总(总反向发电量 - 月)
» keyListALL_RECEIVED_ARR_YEAR反向有功总(总反向发电量 - 年)
» keyListALL_RECEIVED_ARR_TILL_NOW反向有功总(总反向发电量 - 至今)

body 请求示例​

{
"date": "20250124",
"meterId": 16,
"keyList": ["WEEK_OFFLINE", "MONTH_OFFLINE", "YEAR_OFFLINE_ARR"]
}

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue是否成功
» messagestringtrue响应信息
» codeintegertrue响应码
» resultobjecttrue结果,根据请求参数 keyList 返回
»» WEEK_OFFLINEstringtrue周离线次数
»» MONTH_OFFLINEstringtrue月离线次数
»» YEAR_OFFLINE_ARRstringtrue年离线统计列表
» timestampintegertrue时间戳

返回示例​

{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"WEEK_OFFLINE": "0",
"YEAR_OFFLINE": "0",
"TOTAL_OFFLINE": "4",
"MONTH_OFFLINE": "0",
"YEAR_OFFLINE_ARR": "[{\"time\":\"1\",\"value\":0.0},{\"time\":\"2\",\"value\":0.0},{\"time\":\"3\",\"value\":0.0},{\"time\":\"4\",\"value\":0.0},{\"time\":\"5\",\"value\":0.0},{\"time\":\"6\",\"value\":0.0},{\"time\":\"7\",\"value\":0.0},{\"time\":\"8\",\"value\":0.0},{\"time\":\"9\",\"value\":0.0},{\"time\":\"10\",\"value\":0.0},{\"time\":\"11\",\"value\":0.0},{\"time\":\"12\",\"value\":0.0}]"
},
"timestamp": 1737701757706
}