单串电压 （废弃）
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li><del>单串电压</del> 20240517 gjg 取消</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>
<p><code>/api/v1/device/bunch</code></p>
<pre><code class="language-css">请求头中需带上TokenValue字段，传参接收到的token值,用于用户验证</code></pre>
</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<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;">jsonstr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求字符串</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>token密钥</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">jsonstr参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">battery_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>电池编号</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;1&quot;,
&quot;msg&quot;: &quot;获取成功&quot;,
&quot;data&quot;: {
&quot;id&quot;: 76,
&quot;dev_id&quot;: &quot;A5:C2:37:14:90:EB&quot;,
&quot;dev_bunch&quot;: &quot;14&quot;,
&quot;dev_max&quot;: &quot;3256&quot;,
&quot;dev_min&quot;: &quot;3250&quot;,
&quot;dev_avg&quot;: &quot;3253&quot;,
&quot;dev_diff&quot;: &quot;6&quot;,
&quot;bunch1&quot;: &quot;3250&quot;,
&quot;bunch2&quot;:&quot;3252&quot;,
&quot;...&quot;:&quot;3255&quot;,
&quot;bunch22&quot;:&quot;3254&quot;,
&quot;add_time&quot;:&quot;2024-03-26 17:17:05&quot;,
}
}</code></pre>
<h5>失败返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;-999&quot;,
&quot;msg&quot;: &quot;拒绝访问：你没有权限&quot;,
&quot;data&quot;: &quot;&quot;
}</code></pre>
<h5>返回参数说明</h5>
<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;">state</td>
<td style="text-align: left;">string</td>
<td>状态 1为成功，其他为失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>接口返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>信息</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">data中的参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">int</td>
<td>id</td>
</tr>
<tr>
<td style="text-align: left;">dev_id</td>
<td style="text-align: left;">string</td>
<td>电池编码</td>
</tr>
<tr>
<td style="text-align: left;">dev_bunch</td>
<td style="text-align: left;">string</td>
<td>电池串数</td>
</tr>
<tr>
<td style="text-align: left;">dev_max</td>
<td style="text-align: left;">string</td>
<td>最大电压</td>
</tr>
<tr>
<td style="text-align: left;">dev_min</td>
<td style="text-align: left;">string</td>
<td>最小电压</td>
</tr>
<tr>
<td style="text-align: left;">dev_avg</td>
<td style="text-align: left;">string</td>
<td>平均电压</td>
</tr>
<tr>
<td style="text-align: left;">dev_diff</td>
<td style="text-align: left;">string</td>
<td>压差</td>
</tr>
<tr>
<td style="text-align: left;">bunch1</td>
<td style="text-align: left;">string</td>
<td>当前串的电压</td>
</tr>
<tr>
<td style="text-align: left;">bunch2</td>
<td style="text-align: left;">string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">...</td>
<td style="text-align: left;">string</td>
</tr>
<tr>
<td style="text-align: left;">bunch22</td>
<td style="text-align: left;">string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">add_time</td>
<td style="text-align: left;">datetime</td>
<td>日期</td>
</tr>
</tbody>
</table>
<h5>错误代码</h5>
<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;">1</td>
<td style="text-align: left;">string</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">-1</td>
<td style="text-align: left;">string</td>
<td>参数有误</td>
</tr>
<tr>
<td style="text-align: left;">-2</td>
<td style="text-align: left;">string</td>
<td>无相关数据</td>
</tr>
<tr>
<td style="text-align: left;">-99</td>
<td style="text-align: left;">string</td>
<td>异常</td>
</tr>
<tr>
<td style="text-align: left;">-999</td>
<td style="text-align: left;">string</td>
<td>拒绝访问：你没有权限</td>
</tr>
<tr>
<td style="text-align: left;">-9999</td>
<td style="text-align: left;">string</td>
<td>token验证失败</td>
</tr>
</tbody>
</table>