中控详情
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>中控详情</li>
<li>APP首页 根据中控编号查询中控信息</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>
<p><code>/api/v1/cc/info</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;">bike_cc_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;xuhang&quot;:&quot;25.2&quot;,
&quot;data&quot;: {
&quot;id&quot;: 76,
&quot;bike_cc_id&quot;: &quot;012066999840&quot;,
&quot;bike_sn&quot;: &quot;8000001&quot;,
&quot;bike_battery_id&quot;: &quot;A5:C2:37:14:90:AA&quot;,
&quot;bike_csn&quot;: &quot;55255001001&quot;,
&quot;bike_iccid&quot;: &quot;56366552669996301&quot;,
&quot;bike_hw&quot;: &quot;1.2.0&quot;,
&quot;bike_sw&quot;: &quot;1.2.0&quot;,
&quot;ble_switch&quot;: 1,
&quot;ble_dist&quot;: 5,
&quot;dev_mos_cd&quot;: 0,
&quot;dev_mos_fd&quot;: 0,
&quot;dev_xuhang&quot;: 0,
&quot;dev_peak_cd&quot;: 0,
&quot;controller_mode_id&quot;: 76,
&quot;controller_mode_name&quot;: &quot;国标模式:25码&quot;,
&quot;bike_battery_mode&quot;: &quot;40&quot;,
&quot;bike_mac&quot;: &quot;A5:C2:37:14:90:EE&quot;,
&quot;bike_stat&quot;: &quot;1&quot;,
&quot;bike_vin&quot;: &quot;57700&quot;,
&quot;bike_signal&quot;: &quot;1&quot;,
&quot;move_status&quot;: &quot;1&quot;,
&quot;power_status&quot;: &quot;1&quot;,
&quot;ble_status&quot;: &quot;1&quot;,
&quot;last_online_time&quot;:&quot;2024-03-26 15:44:11&quot;,
&quot;online&quot;: &quot;1&quot;,
&quot;bind_time&quot;:&quot;2024-03-26 15:44:11&quot;,
&quot;bind_diff&quot;: &quot;1&quot;,
&quot;bike_name&quot;: &quot;奇迹牛N95 青春版 靓金色&quot;,
&quot;bind_time&quot;: &quot;2024-03-26 15:44:40&quot;,
&quot;bind_diff&quot;: &quot;1&quot;,
&quot;bike_model&quot;: &quot;奇迹牛N95 青春版 靓金色&quot;,
&quot;bike_image&quot;: &quot;http://file.qjn.com/test/2563663.jpg&quot;,
&quot;bike_cover&quot;: &quot;http://file.qjn.com/test/2563663.jpg&quot;,
&quot;dev_voltage&quot;: &quot;72&quot;, //取消
&quot;dev_current&quot;: &quot;15&quot;, //取消
&quot;dev_capacity&quot;: &quot;58.6&quot;, //取消
&quot;dev_xuhang&quot;: &quot;50&quot;, //取消
},
&quot;battery&quot;: {
&quot;id&quot;: 76,
&quot;bike_cc_id&quot;: &quot;012066999840&quot;,
&quot;voltage_nominal&quot;: &quot;40&quot;,
&quot;capacity_nominal&quot;: &quot;80&quot;,
&quot;capacity_surplus&quot;: &quot;60&quot;,
&quot;cd_mode&quot;: &quot;0&quot;,
&quot;cd_voltage&quot;: &quot;60&quot;,
&quot;cd_current&quot;: &quot;4&quot;,
&quot;dev_voltage&quot;: &quot;72&quot;,
&quot;dev_current&quot;: &quot;15&quot;,
&quot;dev_soc&quot;: &quot;50&quot;,
&quot;dev_circulate&quot;: &quot;2&quot;,
&quot;dev_bunch&quot;: &quot;17&quot;,
&quot;dev_temp&quot;: &quot;43&quot;,
&quot;add_time&quot;: &quot;2024-05-17 16:14:58&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;">xuhang</td>
<td style="text-align: left;">string</td>
<td>预估续航里程（KM）</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>中控信息</td>
</tr>
<tr>
<td style="text-align: left;">battery</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;">bike_cc_id</td>
<td style="text-align: left;">string</td>
<td>中控设备编号</td>
</tr>
<tr>
<td style="text-align: left;">bike_sn</td>
<td style="text-align: left;">string</td>
<td>车辆序列号</td>
</tr>
<tr>
<td style="text-align: left;">bike_battery_id</td>
<td style="text-align: left;">string</td>
<td>电池编号</td>
</tr>
<tr>
<td style="text-align: left;">bike_csn</td>
<td style="text-align: left;">string</td>
<td>控制器编号</td>
</tr>
<tr>
<td style="text-align: left;">bike_iccid</td>
<td style="text-align: left;">string</td>
<td>SIM 卡号，物联网 IMSI 号</td>
</tr>
<tr>
<td style="text-align: left;">bike_hw</td>
<td style="text-align: left;">string</td>
<td>中控硬件版本号</td>
</tr>
<tr>
<td style="text-align: left;">bike_sw</td>
<td style="text-align: left;">string</td>
<td>中控固件版本号</td>
</tr>
<tr>
<td style="text-align: left;">bike_mac</td>
<td style="text-align: left;">string</td>
<td>中控蓝牙 MAC 地址</td>
</tr>
<tr>
<td style="text-align: left;">ble_switch</td>
<td style="text-align: left;">int</td>
<td>蓝牙感应状态 0关闭，1开启</td>
</tr>
<tr>
<td style="text-align: left;">ble_dist</td>
<td style="text-align: left;">int</td>
<td>蓝牙感应距离 （米）</td>
</tr>
<tr>
<td style="text-align: left;">dev_mos_cd</td>
<td style="text-align: left;">int</td>
<td>充电MOS开关 0关 1开</td>
</tr>
<tr>
<td style="text-align: left;">dev_mos_fd</td>
<td style="text-align: left;">int</td>
<td>放电MOS开关 0关 1开</td>
</tr>
<tr>
<td style="text-align: left;">dev_xuhang</td>
<td style="text-align: left;">int</td>
<td>续航里程手动校准</td>
</tr>
<tr>
<td style="text-align: left;">dev_peak_cd</td>
<td style="text-align: left;">int</td>
<td>充电峰值</td>
</tr>
<tr>
<td style="text-align: left;">controller_mode_id</td>
<td style="text-align: left;">int</td>
<td>控制器模式ID：国标模式、运动模式、极速模式等</td>
</tr>
<tr>
<td style="text-align: left;">controller_mode_name</td>
<td style="text-align: left;">string</td>
<td>控制器模式名称：国标模式、运动模式、极速模式等</td>
</tr>
<tr>
<td style="text-align: left;">bike_battery_mode</td>
<td style="text-align: left;">string</td>
<td>车辆电池类型，如：48V，60V 用于中控换算</td>
</tr>
<tr>
<td style="text-align: left;">bike_stat</td>
<td style="text-align: left;">string</td>
<td>车辆状态， 0解锁 1启动 2锁车（设防）</td>
</tr>
<tr>
<td style="text-align: left;">bike_vin</td>
<td style="text-align: left;">string</td>
<td>当前电池电压，单位 mV</td>
</tr>
<tr>
<td style="text-align: left;">bike_signal</td>
<td style="text-align: left;">string</td>
<td>中控信号强度 0无信号 1-5代表强度 5最强</td>
</tr>
<tr>
<td style="text-align: left;">move_status</td>
<td style="text-align: left;">string</td>
<td>轮动状态， 1 运动， 0 静止</td>
</tr>
<tr>
<td style="text-align: left;">power_status</td>
<td style="text-align: left;">string</td>
<td>通电状态， 1 通电， 0 断电</td>
</tr>
<tr>
<td style="text-align: left;">ble_status</td>
<td style="text-align: left;">string</td>
<td>蓝牙连接状态， 1 连接，0 断开</td>
</tr>
<tr>
<td style="text-align: left;">last_online_time</td>
<td style="text-align: left;">datetime</td>
<td>最后通讯时间</td>
</tr>
<tr>
<td style="text-align: left;">online</td>
<td style="text-align: left;">string</td>
<td>3分钟内是否在线，0在线，1不在线</td>
</tr>
<tr>
<td style="text-align: left;">bind_time</td>
<td style="text-align: left;">datetime</td>
<td>绑定时间</td>
</tr>
<tr>
<td style="text-align: left;">bind_diff</td>
<td style="text-align: left;">string</td>
<td>绑定时长（天）</td>
</tr>
<tr>
<td style="text-align: left;">bike_name</td>
<td style="text-align: left;">string</td>
<td>车辆名称(用户自定义名称)</td>
</tr>
<tr>
<td style="text-align: left;">remote_expire_time</td>
<td style="text-align: left;">datetime</td>
<td>远程智能服务过期时间</td>
</tr>
<tr>
<td style="text-align: left;">diff</td>
<td style="text-align: left;">string</td>
<td>是否过期 0表示当天 小于0表示剩余天数 大于0表示已过期天数</td>
</tr>
<tr>
<td style="text-align: left;">bike_model</td>
<td style="text-align: left;">string</td>
<td>车辆型号</td>
</tr>
<tr>
<td style="text-align: left;">bike_image</td>
<td style="text-align: left;">string</td>
<td>车辆图片</td>
</tr>
<tr>
<td style="text-align: left;">bike_cover</td>
<td style="text-align: left;">string</td>
<td>车辆封面</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">battery中的参数名</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;">bike_cc_id</td>
<td style="text-align: left;">string</td>
<td>中控设备编号</td>
</tr>
<tr>
<td style="text-align: left;">voltage_nominal</td>
<td style="text-align: left;">string</td>
<td>标称电压 40V</td>
</tr>
<tr>
<td style="text-align: left;">capacity_nominal</td>
<td style="text-align: left;">string</td>
<td>标称容量 80Ah</td>
</tr>
<tr>
<td style="text-align: left;">capacity_surplus</td>
<td style="text-align: left;">string</td>
<td>剩余容量 60Ah</td>
</tr>
<tr>
<td style="text-align: left;">cd_mode</td>
<td style="text-align: left;">string</td>
<td>充电模式 0</td>
</tr>
<tr>
<td style="text-align: left;">cd_voltage</td>
<td style="text-align: left;">string</td>
<td>需求充电电压 60V</td>
</tr>
<tr>
<td style="text-align: left;">cd_current</td>
<td style="text-align: left;">string</td>
<td>需求充电电流 4A</td>
</tr>
<tr>
<td style="text-align: left;">dev_voltage</td>
<td style="text-align: left;">string</td>
<td>当前电压</td>
</tr>
<tr>
<td style="text-align: left;">dev_current</td>
<td style="text-align: left;">string</td>
<td>当前电流</td>
</tr>
<tr>
<td style="text-align: left;">dev_soc</td>
<td style="text-align: left;">string</td>
<td>SOC，电量百分比</td>
</tr>
<tr>
<td style="text-align: left;">dev_circulate</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_temp</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;">string</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;">-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>