1、心跳
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>心跳回调地址</code></li>
</ul>
<p>机柜登陆成功后每隔 30 秒向服务器发送一次心跳消息</p>
<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;">macno</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备号</td>
</tr>
<tr>
<td style="text-align: left;">battery_param</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array()</td>
<td>电池基本参数(具体参见下面电池基本参数)</td>
</tr>
<tr>
<td style="text-align: left;">relative_electricity</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>相对充满电量（%）</td>
</tr>
<tr>
<td style="text-align: left;">absolute_electricity</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>绝对充放电量（%）</td>
</tr>
<tr>
<td style="text-align: left;">battery_health</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池健康度（%）</td>
</tr>
<tr>
<td style="text-align: left;">charge_discharge_nums</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池充放电次数</td>
</tr>
<tr>
<td style="text-align: left;">current</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前电流值（mA）</td>
</tr>
<tr>
<td style="text-align: left;">voltage</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前电压值（mV）</td>
</tr>
<tr>
<td style="text-align: left;">temperature</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前温度（℃）</td>
</tr>
<tr>
<td style="text-align: left;">electricity</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>当前剩余电量（%）</td>
</tr>
<tr>
<td style="text-align: left;">times</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>剩余使用时间(分钟)</td>
</tr>
<tr>
<td style="text-align: left;">battery_status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array()</td>
<td>电池状态（具体参参见下面电池状态参数）</td>
</tr>
<tr>
<td style="text-align: left;">alarm_param</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array()</td>
<td>警告参数（具体参见下面警告参数）</td>
</tr>
<tr>
<td style="text-align: left;">protect_param</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array()</td>
<td>保护参数（具体参见下面保护参数）</td>
</tr>
<tr>
<td style="text-align: left;">product_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>产品名称</td>
</tr>
<tr>
<td style="text-align: left;">serial_number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>序列号</td>
</tr>
<tr>
<td style="text-align: left;">error</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array()</td>
<td>故障代码（具体参见下面故障代码参数）</td>
</tr>
<tr>
<td style="text-align: left;">longitude_latitude</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>经纬度</td>
</tr>
<tr>
<td style="text-align: left;">ctime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>心跳返回时间戳</td>
</tr>
</tbody>
</table>
<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;">current</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池电流（mA）</td>
</tr>
<tr>
<td style="text-align: left;">voltage</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池电压（mV）</td>
</tr>
<tr>
<td style="text-align: left;">temperature</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池温度（℃）</td>
</tr>
<tr>
<td style="text-align: left;">electricity</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>剩余电量(%)</td>
</tr>
<tr>
<td style="text-align: left;">times</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>剩余时间(分钟)</td>
</tr>
</tbody>
</table>
<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;">charge_discharge_status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充放电状态:(0:静置 1:充电 2:放电)</td>
</tr>
<tr>
<td style="text-align: left;">BMS</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>BMS信息:(0:正常 1:故障)</td>
</tr>
</tbody>
</table>
<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;">D0</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电芯过压告警</td>
</tr>
<tr>
<td style="text-align: left;">D1</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电芯过放告警</td>
</tr>
<tr>
<td style="text-align: left;">D2</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充电电芯高温告警</td>
</tr>
<tr>
<td style="text-align: left;">D3</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充电电芯低温告警</td>
</tr>
<tr>
<td style="text-align: left;">D4</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>放电电芯高温告警</td>
</tr>
<tr>
<td style="text-align: left;">D5</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>放电电芯低温告警）</td>
</tr>
<tr>
<td style="text-align: left;">D6</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充电电电芯过流告警</td>
</tr>
<tr>
<td style="text-align: left;">D7</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>放电电电芯过流告警</td>
</tr>
</tbody>
</table>
<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;">D0</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电芯过压保护</td>
</tr>
<tr>
<td style="text-align: left;">D1</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电芯过放保护</td>
</tr>
<tr>
<td style="text-align: left;">D2</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充电电芯高温保护</td>
</tr>
<tr>
<td style="text-align: left;">D3</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充电电芯低温保护</td>
</tr>
<tr>
<td style="text-align: left;">D4</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>放电电芯高温保护</td>
</tr>
<tr>
<td style="text-align: left;">D5</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>放电电芯低温保护）</td>
</tr>
<tr>
<td style="text-align: left;">D6</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>充电过流保护</td>
</tr>
<tr>
<td style="text-align: left;">D7</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>放电过流保护</td>
</tr>
</tbody>
</table>
<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;">D0</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池欠压</td>
</tr>
<tr>
<td style="text-align: left;">D1</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池高温故障</td>
</tr>
<tr>
<td style="text-align: left;">D2</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池低温故障</td>
</tr>
<tr>
<td style="text-align: left;">D3</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>电池过流（预警等级、1代表1级）</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 1,
"msg": "心跳信息",
"data": {
"macno": "3333333344444444",
"battery_param": {
"current": 0,
"voltage": 45980,
"temperature": 34,
"electricity": 49,
"times": 65535
},
"relative_electricity": 49,
"absolute_electricity": 49,
"battery_health": 100,
"charge_discharge_nums": 0,
"current": 0,
"voltage": 45980,
"temperature": 34,
"electricity": 49,
"times": 65535,
"battery_status": {
"charge_discharge_status": 0,
"BMS": 0
},
"alarm_param": {
"D0": 0,
"D1": 0,
"D2": 0,
"D3": 0,
"D4": 0,
"D5": 0,
"D6": 0,
"D7": 0
},
"protect_param": {
"D0": 0,
"D1": 0,
"D2": 0,
"D3": 0,
"D4": 0,
"D5": 0,
"D6": 0,
"D7": 0
},
"product_name": "SMT13S25M",
"serial_number": "SN00001",
"error": {
"D0": 0,
"D1": 0,
"D2": 0,
"D3": 0
},
"longitude_latitude": "0,0",
"ctime": 1537362534
}
}</code></pre>