峰谷电API
# 峰谷电数据接口
字段说明
字段请查看字段说明
接口说明
根据查询条件查询峰谷电设置情况
接口版本
v1接口地址
https://energy.25soft.com/api/peakvalleys
请求方法
GET
请求参数
参数类型 | 参数名称 | 数据类型 | 是否必须 | 参数描述 | 默认 | 示例 |
---|---|---|---|---|---|---|
query | time | string | false | 时间范围查询字段,必须是层级中的时间或时间戳字段名,例如createdAt,updatedAt time | createdAt | |
query | range | string[] | false | 时间范围,开始时间到结束时间,可以是string[] | [2019-10-22T00:00:00.000Z,2022-01-22T00:00:00.000Z] | |
query | page | number | false | 分页第几页 | 1 | |
query | limit | number | false | 单页几条数据 | 10 | |
query | sort | string | false | 根据哪个字段排序 | _id | -createdAt |
query | select | string | false | 只查询部分字段,字段名之间用过空格分隔,去掉某个字段的查询字段名前面加- | ||
query | autopopulate | boolean | false | 自动关联数据,部分字段自动关联关系表查询,设置这个值可开关自动联表查询 | true | false |
请求参数举例
注意
GET请求所有参数类型都会变成string拼接在url上面,文档为了表述清晰,将示例结构以json格式编写
{
"page":"1",
"limit":"10",
"sort":"-createdAt",
"autopopulate":"false"
}
// Make sure to add code blocks to your code group
返回参数
参数名称 | 数据类型 | 是否必须 | 参数描述 |
---|---|---|---|
code | number | True | 是否成功 |
data | json | True | 返回数据 |
-total | number | False | 峰谷电总条数 |
-rows | array | False | 当前返回的峰谷电列表 |
返回参数举例
{
"code": 0,
"data": {
"total": 3,
"rows": [
{
"typeFlag": 0,
"peakStatus": 0,
"_id": "60a75e7013bf34b76dc034d4",
"money": 1.1146,
"status": true,
"data_type": 0,
"timeArr": [
{
"_id": "60a75e7013bf34832cc034d5",
"nextDay": false,
"btime": "19:00",
"etime": "21:00",
"createdAt": "2021-05-21T07:17:04.181Z",
"updatedAt": "2021-05-21T07:17:04.181Z"
}
],
"name": "尖峰电价",
"creator": "602e05d2c40a0b001bb6161b",
"createdAt": "2021-05-21T07:17:04.181Z",
"updatedAt": "2021-05-21T07:17:04.181Z",
"__v": 0
},
{
"typeFlag": 0,
"peakStatus": 0,
"_id": "60a75e5713bf3427efc034d0",
"money": 0.9326,
"status": true,
"data_type": 0,
"timeArr": [
{
"_id": "60a75e5713bf34a45cc034d1",
"nextDay": false,
"btime": "08:00",
"etime": "11:00",
"createdAt": "2021-05-21T07:16:39.506Z",
"updatedAt": "2021-05-21T07:16:39.506Z"
},
{
"_id": "60a75e5713bf34bd57c034d2",
"nextDay": false,
"btime": "13:00",
"etime": "19:00",
"createdAt": "2021-05-21T07:16:39.506Z",
"updatedAt": "2021-05-21T07:16:39.506Z"
},
{
"_id": "60a75e5713bf3411ecc034d3",
"nextDay": false,
"btime": "21:00",
"etime": "22:00",
"createdAt": "2021-05-21T07:16:39.507Z",
"updatedAt": "2021-05-21T07:16:39.507Z"
}
],
"name": "高峰电价",
"creator": "602e05d2c40a0b001bb6161b",
"createdAt": "2021-05-21T07:16:39.507Z",
"updatedAt": "2021-05-21T07:16:39.507Z",
"__v": 0
},
{
"typeFlag": 0,
"peakStatus": 0,
"_id": "60a75e1513bf3414efc034cd",
"money": 0.4486,
"status": true,
"data_type": 0,
"timeArr": [
{
"_id": "60a75e1513bf342c1cc034ce",
"nextDay": true,
"btime": "22:00",
"etime": "08:00",
"createdAt": "2021-05-21T07:15:33.617Z",
"updatedAt": "2021-05-21T07:15:33.617Z"
},
{
"_id": "60a75e1513bf3417c6c034cf",
"nextDay": false,
"btime": "11:00",
"etime": "13:00",
"createdAt": "2021-05-21T07:15:33.617Z",
"updatedAt": "2021-05-21T07:15:33.617Z"
}
],
"name": "低谷电价",
"creator": "602e05d2c40a0b001bb6161b",
"createdAt": "2021-05-21T07:15:33.618Z",
"updatedAt": "2021-05-21T07:15:33.618Z",
"__v": 0
}
]
}
}
上次更新: 2022/06/13, 16:07:54