2 控制命令
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://120.77.72.190:8088/api/HeyuanCtl/control</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </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;">imei</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>设备imei</td>
</tr>
<tr>
<td style="text-align: left;">com</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>指令 ID(见下表)</td>
</tr>
<tr>
<td style="text-align: left;">body</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>消息体(见下表)</td>
</tr>
</tbody>
</table>
<p><strong>指令列表：</strong></p>
<table>
<thead>
<tr>
<th>指令 ID</th>
<th>消息体</th>
<th>备注</th>
<th>支持版本</th>
</tr>
</thead>
<tbody>
<tr>
<td>锁车命令：01</td>
<td></td>
<td>点火状态下直接返回失败</td>
<td></td>
</tr>
<tr>
<td>解锁命令：02</td>
<td></td>
<td>点火状态下直接返回失败</td>
<td></td>
</tr>
<tr>
<td>寻车命令：03</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>断电/锁档：04</td>
<td></td>
<td>收到指令时如果低于预置速度（5 km/h）则执行，否则失败；然后返回执行结果。另见：强制锁档指令 14</td>
<td></td>
</tr>
<tr>
<td>供电/档解锁：05</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>终端重启：06</td>
<td></td>
<td>点火状态下拒绝执行，直接返回失败</td>
<td></td>
</tr>
<tr>
<td>获取gps：07</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>获取车辆状态：08</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>获取总里程和速度：09</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>清空里程缓存：0A</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>立即拍照并上传： 0B</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>立即拍照： 0C</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>间隔XX分钟拍照一张并上传： 0D</td>
<td>时间间隔，单位分</td>
<td></td>
<td></td>
</tr>
<tr>
<td>开启录像： 0E</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>关闭录像： 0F</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>获取VinCode： 10</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td><del>蓝牙开关：11</del></td>
<td><del>pin 码字符串</del></td>
<td><del>pin 码有效时打开蓝牙，为 0 时清除 pin 码并关闭蓝牙</del></td>
<td><del>3.0.100+</del></td>
</tr>
<tr>
<td>订单开始：12</td>
<td>消息体同蓝牙开关</td>
<td>按硬件能响应的最小间隔依次执行以下指令：打开 蓝牙 或 Wi-Fi 指令，供电(05)。同时车辆进入『已租』状态，出现终端重启等特殊情况，各状态默认按可用处理。</td>
<td>3.0.100+ 提供/ 3.0.200+ 起消息体由 short 变为字符串，服务器做兼容处理</td>
</tr>
<tr>
<td>订单结束：13</td>
<td></td>
<td>按硬件能响应的最小间隔依次执行以下指令：锁车(01)，判断状态是否符合还车条件（否则直接返回错误码），断电(04)，关闭 蓝牙 或 Wi-Fi 。同时车辆进入『未租』状态，出现特殊情况时，在保证安全的前提下，各状态默认按不可用处理。<strong>点火状态下拒绝执行，直接返回失败。（点火状态不允许还车）</strong></td>
<td>3.0.100+</td>
</tr>
<tr>
<td>强制断电/锁档：14</td>
<td></td>
<td>行驶过程中延迟到低于预置速度（5 km/h）后执行；只要同意执行即可返回成功，不需等待执行结果。具体是断电还是锁档，根据车型特点决定。另见：一次性锁档指令 04</td>
<td>3.0.100+</td>
</tr>
<tr>
<td>强制订单结束：15</td>
<td></td>
<td>同 13 ，但不作状态判断。仅供状态错误时后台强制结束用。</td>
<td></td>
</tr>
<tr>
<td>中间段保留</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>打开 Wi-Fi 热点: 21</td>
<td>消息体内容为指定格式字符串</td>
<td>车载端收到该指令时，根据收到的字符串设置 Wi-Fi 热点 名字 和 密码，并打开。格式为<code>名字:密码</code></td>
<td>3.0.200+</td>
</tr>
<tr>
<td>关闭 Wi-Fi 热点：22</td>
<td></td>
<td></td>
<td>3.0.200+</td>
</tr>
<tr>
<td>改变心跳包上报频率：23</td>
<td>数字（单位为秒）</td>
<td>车载端收到该指令时，同意执行时，根据收到的信息去改变心跳包的上报频率，返回成功；否则返回失败。</td>
<td>3.0.200+</td>
</tr>
<tr>
<td>中间段预留扩展用</td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>服务器设置：7E</td>
<td>格式 端口号:ip 。ip代表服务器 IP 或者 域名，多个地址用英文分号；隔开</td>
<td>点火状态下拒绝执行，直接返回失败；如果同意变更，向旧服务器返回成功后，马上向新服务器发起连接</td>
<td>3.0.100+</td>
</tr>
<tr>
<td>重置连接：7F</td>
<td></td>
<td>车载端收到该指令时，需要重新发起握手，优先级最高。一般情况下是因为服务器重启等原因，丢失了密钥。这时收到心跳包但无法解析，所以向该 Socket 发出重置指令。该指令一定是明文。不要求响应</td>
<td></td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 1,//1:成功 其他：失败
"data": "",
"msg": "发送成功"
}</code></pre>