获取项目能源消耗统计
<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-03-13 13:08:59 星期四</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/energyCollect.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>此接口的token需要拼接在请求地址内，请将示例内的<code>${token}</code>替换为实际的token值</li>
<li>此接口有数据的前提为：已在平台对应项目建立好相关能源分析分组，并绑定好设备。已经完成的请忽略</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>子查询集合，包含内容如下。注意单次检索中，子查询的个数不可超过4</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;">projectId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long</td>
<td>项目id</td>
</tr>
</tbody>
</table>
<p><strong>请求示例</strong></p>
<pre><code>{
&quot;subQueries&quot;: [
{
&quot;startTimeStr&quot;: &quot;2025-03-13&quot;,
&quot;endTimeStr&quot;: &quot;2025-03-13&quot;,
&quot;energyTypeList&quot;: [&quot;Energy&quot;],
&quot;projectId&quot;: &quot;12345679&quot;
}
]
}
</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
&quot;statusCode&quot;: 200,
&quot;message&quot;: &quot;Success&quot;,
&quot;result&quot;: {
&quot;dataList&quot;: [
{
&quot;startTime&quot;: 1741795200000,
&quot;endTime&quot;: 1741881599999,
&quot;valueList&quot;: [
{
&quot;energyType&quot;: &quot;Energy&quot;,
&quot;amount&quot;: &quot;716.5&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;">energyType</td>
<td style="text-align: left;">String</td>
<td>能耗类型</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">String</td>
<td>能源消耗值</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>