获取设备区间能耗曲线
<p><strong>日志：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">版本号</th>
<th style="text-align: left;">撰写人</th>
<th style="text-align: left;">时间</th>
<th>修改内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">VA 1.0.0</td>
<td style="text-align: left;">lee</td>
<td style="text-align: left;">2025-11-11 14:01:30 星期二</td>
<td>创建</td>
</tr>
</tbody>
</table>
<p><strong>简要描述：</strong></p>
<ul>
<li>获取设备区间能耗曲线</li>
</ul>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>https://www.zsdcloud.cn:8443/openApi/dataStatistics/deviceEnergyConsume.action?token=${token}</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
<li>注意，此接口的<code>Content-Type</code>为：<strong>application/json</strong></li>
</ul>
<p><strong>注意事项：</strong> </p>
<ul>
<li>此接口有流控限制，当前为单客户端ip：3次/秒</li>
<li>此接口的token需要拼接在请求地址内，请将示例内的<code>${token}</code>替换为实际的token值</li>
<li>此接口有数据的前提为：设备为能耗设备，具有<strong>用电量</strong>、<strong>用气量</strong>或<strong>用水量</strong>相关数据</li>
</ul>
<p><strong>参数：</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">subQueries</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">JSONArray</td>
<td>子查询集合，包含内容如下。注意单次检索中，子查询的个数不可超过5个</td>
</tr>
<tr>
<td style="text-align: left;">startTimeStr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>起始时间，格式：<code>yyyy-MM-dd</code>。eg:<code>2025-03-13</code>，意为起始时间为：2025-03-13的0点0分0秒</td>
</tr>
<tr>
<td style="text-align: left;">endTimeStr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>结束时间，格式：<code>yyyy-MM-dd</code>。eg:<code>2025-03-13</code>，意为结束时间为：2025-03-13的23点59分59秒</td>
</tr>
<tr>
<td style="text-align: left;">energyTypeList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Array</td>
<td>能耗类型集，<br/>电：<code>Energy</code>，<br/>水：<code>WaterFlow</code>，<br/>气：<code>Gas</code>，<br/>碳排放：<code>CarbonEmission</code>，<br/>折标煤炭：<code>StandardCoal</code></td>
</tr>
<tr>
<td style="text-align: left;">keyCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>设备识别码</td>
</tr>
<tr>
<td style="text-align: left;">childDeviceKey</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>子设备识别码</td>
</tr>
<tr>
<td style="text-align: left;">aggregationCycle</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>能耗的聚合周期，支持以下聚合类型：<br/>按天聚合：<code>day</code>，<br/>按小时聚合：<code>hour</code>，返回参数中的时间粒度会遵循此参数</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>{
&quot;subQueries&quot;: [
{
&quot;startTimeStr&quot;: &quot;2025-11-01&quot;,
&quot;endTimeStr&quot;: &quot;2025-11-10&quot;,
&quot;energyTypeList&quot;: [&quot;Energy&quot;],
&quot;keyCode&quot;: &quot;12345679&quot;,
&quot;aggregationCycle&quot;: &quot;day&quot;
}
]
}
</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
&quot;statusCode&quot;: 200,
&quot;message&quot;: &quot;Success&quot;,
&quot;result&quot;: [
{
&quot;startTime&quot;: 1640966400000,
&quot;endTime&quot;: 1672502399999,
&quot;energyType&quot;: &quot;Energy&quot;,
&quot;valueList&quot;: [
{
&quot;timestamp&quot;: 1640966400000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1643644800000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1646064000000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1648742400000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1651334400000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1654012800000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1656604800000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1659283200000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1661961600000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1664553600000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1667232000000,
&quot;value&quot;: &quot;0.0&quot;
},
{
&quot;timestamp&quot;: 1669824000000,
&quot;value&quot;: &quot;0.0&quot;
}
]
}
]
}
</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">dataList</td>
<td style="text-align: left;">JSONArray</td>
<td>数据集集合，通常来说subQueries有几个，dataList会返回对应的数据</td>
</tr>
<tr>
<td style="text-align: left;">startTime</td>
<td style="text-align: left;">Long</td>
<td>对应subQueries对应项的起始时间</td>
</tr>
<tr>
<td style="text-align: left;">endTime</td>
<td style="text-align: left;">Long</td>
<td>对应subQueries对应项的结束时间</td>
</tr>
<tr>
<td style="text-align: left;">valueList</td>
<td style="text-align: left;">JSONArray</td>
<td>值集合，<strong>如果设备对应时间段没有数据，可能会返回空数组</strong></td>
</tr>
<tr>
<td style="text-align: left;">timestamp</td>
<td style="text-align: left;">long</td>
<td>对应时间时间戳</td>
</tr>
<tr>
<td style="text-align: left;">value</td>
<td style="text-align: left;">string</td>
<td>能源区间值</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>