设备历史数据 | ||||
---|---|---|---|---|
接口描述 | 设备历史数据 | |||
请求URL | https://api.solarmanpv.com/device/v1.0/historical | |||
请求方式 | post | |||
请求类型 | application/json | |||
返回类型 | / | |||
请求参数 | ||||
参数名 | 数据类型 | 参数类型 | 是否必填 | 描述说明 |
language | string | query | N | 语言类型,示例值:zh |
authorization | string | header | Y | accessToken,示例值:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9 |
deviceId | integer | body | N | 设备在平台内的唯一标识 ,示例值:252525 |
deviceSn | string | body | Y | 设备的唯一标识 ,示例值:12583SS |
endTime | string | body | Y | 结束时间 yyyy-MM-dd 或 yyyy-MM 或 yyyy ,示例值:2019-11-18 |
startTime | string | body | Y | 开始时间 yyyy-MM-dd 或 yyyy-MM 或 yyyy ,示例值:2019-11-18 |
timeType | integer | body | Y | 取值类型 1. 帧:指定某日的帧数据 1. 日:指定数日的统计数据(不超过30天) 1. 月:指定数月的统计数据(不超过12个月) 1. 年:指定数年的统计数据 |
示例值:1 |
| userId | integer | body | Y | 账号ID ,示例值:1234 |
| 响应参数 | | | | |
| 参数名 | 数据类型 | 参数类型 | 是否必填 | 描述说明 |
| code | string | body | N | 信息码 ,示例值:10000 |
| deviceId | integer | body | N | 设备在平台内的唯一标识 ,示例值:252525 |
| deviceSn | string | body | N | 设备的唯一标识 ,示例值:12583SS |
| deviceType | string | body | N | 设备类型 ,示例值:C0LLECTOR |
| paramDataList | array | body | N | 数据列表 ,示例值:paramDataList |
| collectTime | string | body | N | timeType不同,格式不同 1:时间戳 2:yyyy-MM-dd 3:yyyy-MM 4:yyyy ,示例值:123456 |
| dataList | array | body | N | 数据 ,示例值:dataList |
| key | string | body | N | 参数key ,示例值:PG_Pt1 |
| name | string | body | N | 参数名称 ,示例值:电网总功率 |
| unit | string | body | N | 参数单位 ,示例值:W |
| value | string | body | N | 参数值 ,示例值:55 |
| timeType | integer | body | N | 取值类型 1.帧:指定某日的帧数据 2.日:指定数日的统计数据(不超过30天) 3.月:指定数月的统计数据(不超过12个月) 4.年:指定数年的统计数据 ,示例值:1 |
| msg | string | body | N | 信息描述 ,示例值:success |
| success | boolean | body | N | 是否成功 ,示例值:true |
| requestId | string | body | N | 请求标识 ,示例值:1d6f6eca9bee4b6483d4af064b659eec |
| 示例 | | | | |
| 请求参数 | {
“timeType”: 4,
“startTime”: “2019”,
“endTime”: “2020”,
“deviceSn”: “dev1800078101”,
“deviceId”: 200203179
} | | | |
| 返回值 | {
“code”: null,
“msg”: null,
“success”: true,
“requestId”: “150657ef285d414894870310d03b448e”,
“deviceSn”: “dev1800078101”,
“deviceId”: 200203179,
“deviceType”: “INVERTER”,
“timeType”: 4,
“paramDataList”: [
{
“collectTime”: “2019”,
“dataList”: [
{
“key”: “generation”,
“value”: “9292.00”,
“unit”: “kWh”,
“name”: “Production”
}
]
},
{
“collectTime”: “2020”,
“dataList”: [
{
“key”: “generation”,
“value”: “16935.00”,
“unit”: “kWh”,
“name”: “Production”
}
]
}
]
} | | | |