设备历史数据
    接口描述 设备历史数据
    请求URL https://api.solarmanpv.com/device/v1.0/historical
    请求方式 post
    请求类型 application/json
    返回类型 /
    请求参数
    参数名 数据类型 参数类型 是否必填 描述说明
    language string query N 语言类型,示例值:zh
    authorization string header Y accessToken,示例值:eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
    companyId integer body N 商家的Id。账号若登录商家版,此字段必传 ,示例值:22
    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”
    }
    ]
    }
    ]
    } | | | |