1 回调设置
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>http://120.77.72.190:8088/api/HeyuanCtl/setCallBackUrl</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;">sys_url</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>心跳回调地址</td>
</tr>
<tr>
<td style="text-align: left;">start_url</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>建立虚连接回调地址</td>
</tr>
<tr>
<td style="text-align: left;">response_url</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>设备回应回调地址</td>
</tr>
<tr>
<td style="text-align: left;">timeout_url</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>设备回应超时回调地址</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义签名</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 1,
"data": "",
"msg": "回调地址设置成功"
}</code></pre>
<hr />
<h1>回调数据</h1>
<h4>心跳回调</h4>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>心跳回调地址</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>数据格式：</strong> </p>
<pre><code class="language-json">
{
"time": 1546598956,
"seq": 2,
"imei": '',
"gps": 2,//0=关闭 / 1=GPS 84 / 2=GPS NEMA / 3=GPS baidu / 11=BD1 / 12=BD2 / 21=GNSS （注：目前是2 GPS）
"latitude": '',//纬度(百度地图)
"longitude": '',//经度(百度地图)
"gps_latitude": '',//纬度
"gps_longitude": '',//经度
"bearing": '',//当前方位
"speed": '',//当前速度
"altitude": '',//当前海拔
"sensor_x": '',//传感器X
"sensor_y": '',//传感器Y
"sensor_z": '',//传感器Z
"cpu_temp": '',//CPU温度
"soc": '',//电量Soc
"odo": '',//总里程
"surplus_mileage": '',//剩余里程
"soc_status": '',//30时非充电状态，31时充电状态
"volt": '',//电池电压
"lpk": '',//功率
"log_time": '',//GPS 时间
"status": {//组合状态
"start": 0,//启动：0=熄火，1=点火
"gps": 0,//GPS：0=关闭，1=开启
"wifi": 0,//wifi：0=关闭，1=开启
"bluetooth": 0,//蓝牙：0=关闭，1=开启
"headlights": 0,//车灯：0=关闭，1=开启
"window": 0,//车窗：0=关闭，1=开启
"left_door": 0,//左门：0=关闭，1=开启
"right_door": 0,//右门：0=关闭，1=开启
"back_door": 0,//尾门：0=关闭，1=开启
"can": [0, 1],//对应CAN1-2：0=关闭，1=开启 （车机CAN总线）
"cam": [0, 1, 0, 1, 0, 1, 0],//对应CAM1-7：0=关闭，1=开启 （摄像头）
"gps_signal": "",//GPS信号强度：00=无信号，01=信号弱，10=信号强，11=信号满
"signal": "",//通信信号强度：00=无信号，01=信号弱，10=信号强，11=信号满
"obd": "",//OBD协议类型（车型相关）
"vincode_ready": 0,//VinCode Ready：0=无VinCode，1=有VinCode
"hours": 0,//开机小时数
"received": "",//接收到命令：00=无，01=下发指令，10=遥控拍照
"executed": ""//执行完命令：00=无，01=下发任务，10=拍照1张，11=拍照2张
}
}
</code></pre>
<hr />
<h4>建立虚连接回调</h4>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>建立虚连接回调地址</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;">vincode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>车辆识别码，如果车还没点火无法获取 vincode ，vincode 为空</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>版本号 例子：2.6.101</td>
</tr>
<tr>
<td style="text-align: left;">classifier</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>可选，为任意字符串，用来表示一些特殊处理的情况（例如车型）</td>
</tr>
<tr>
<td style="text-align: left;">seq</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义签名</td>
</tr>
</tbody>
</table>
<hr />
<h4>设备回应回调</h4>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>设备回应回调地址</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;">seq</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义签名</td>
</tr>
</tbody>
</table>
<p><strong>附加参数：</strong> </p>
<ul>
<li>当com=07</li>
</ul>
<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;">latitude</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>纬度(百度地图)</td>
</tr>
<tr>
<td style="text-align: left;">longitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>经度(百度地图)</td>
</tr>
<tr>
<td style="text-align: left;">gps_latitude</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>纬度</td>
</tr>
<tr>
<td style="text-align: left;">gps_longitude</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>经度</td>
</tr>
</tbody>
</table>
<ul>
<li>当com=09</li>
</ul>
<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;">odo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>总里程</td>
</tr>
<tr>
<td style="text-align: left;">speed</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>速度</td>
</tr>
</tbody>
</table>
<ul>
<li>当com=10</li>
</ul>
<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;">vin_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>车辆识别码</td>
</tr>
</tbody>
</table>
<ul>
<li>当com为07、09、10 且出错时 附加参数为：</li>
</ul>
<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;">result</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>错误码</td>
</tr>
</tbody>
</table>
<ul>
<li>当com为其他时(0B、OD待定)</li>
</ul>
<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;">result</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>31 表示成功，除此以外均表示失败。具体错误码逐步完善中。32 表示执行中。控制命令发出后，服务器的等待超时是 10s，10s 后没有收到响应视作失败；如果10s 内收到 『执行中』，则等待时间再延长 10s，只延长一次。</td>
</tr>
</tbody>
</table>
<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;">01</td>
<td style="text-align: left;">OBD 返回失败</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">02</td>
<td style="text-align: left;">车门未关</td>
<td>锁门 / 还车</td>
</tr>
<tr>
<td style="text-align: left;">03</td>
<td style="text-align: left;">尾门未关</td>
<td>锁门 / 还车</td>
</tr>
<tr>
<td style="text-align: left;">04</td>
<td style="text-align: left;">点火状态</td>
<td>解锁 / 锁门 / 还车 / 重启</td>
</tr>
<tr>
<td style="text-align: left;">05</td>
<td style="text-align: left;">速度大于 5 km/h</td>
<td>（非强制）禁止驾驶</td>
</tr>
<tr>
<td style="text-align: left;">06</td>
<td style="text-align: left;">正在获取 vin</td>
<td>所有需要通过单片机的指令（重启/GPS/拍照等 除外）</td>
</tr>
</tbody>
</table>
<hr />
<hr />
<h4>设备超时回调</h4>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>timeout_url</code></li>
</ul>
<p><strong>服务器收到需要回应 success ,否则会重发一次</strong></p>
<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;">seq</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>自定义签名</td>
</tr>
</tbody>
</table>
<hr />