3.33查询行程接口
**请求地址:** - `/ivci/api/vehicle/getTrips` **请求方式:** - POST,GET **参数说明** |参数名称|类型|说明|备注| |:---- |:---|:----- |----- | |content |String |请求的加密数据 |必填 | |merchantId |String |请求用户所属商户 | 必填 | **备注** content经过RSA解密后的json格式 ``` { "userName":"testuser", "antiFake":"4bbab6ff0d8042548cc6f2df9f3655fa", "timestamp":"20160518165030", "serverIP":"127.0.0.1", "data":{ "startTime":"2017-09-06 00:00:00", "endTime":"2017-09-07 00:00:00", "vehicleIds":"123,4899,258" } } ``` **content参数说明** |名称|类型|说明|备注| |:---- |:---|:----- |----- | |userName| String| 用户名 |必须| |antiFake| String| 防伪随机串 |必须| |timestamp| String| 请求时间戳,精确到秒 |必须| |serverIP| String| 服务器IP |必须| |data| json| 查询车辆信息 |必须| |data.startTime| String |查询开始时间,格式:yyyy-MM-DD HH:mm:ss| 必须| |data.endTime| String |查询结束时间,格式:yyyy-MM-DD HH:mm:ss| 必须| |data.vehicleIds| String |查询车辆Id,多个以英文逗号分隔。和pns,二选一,如果两个都填,优先vehicleIds。司机信息和车辆信息,必须填一种| 非必填| |data.pns| String |查询车辆绑定设备的PN,多个以应分逗号分隔。和vehicleIds,二选一,如果两个都填,优先vehicleIds。司机信息和车辆信息,必须填一种| 非必填| |data.driverIds| String |查询司机Id,多个以英文逗号分隔。和司机手机号,二选一,如果两个都填,则优先司机Id。 司机信息和车辆信息,必须填一种| 非必填| |data.phones| String |查询司机手机号,多个以英文逗号分隔。和司机Id,二选一,如果两个都填,优先司机Id。司机信息和车辆信息,必须填一种| 非必填| **使用示例:** 1. 后台 ```java SimpleDateFormat formatter = new SimpleDateFormat ("yyyyMMddHHmmss"); String timestamp=formatter.format(new Date()); String signStr=RSAUtils.sign(timestamp.getBytes(), privateKey); String ip=request.getRemoteAddr(); //用私钥加密 String ext=",\"data\":{.............}";//组装请求参数 String dataStr="{\“userName\":\"testuser\",\“antiFake\":\""+signStr+"\",\“timestamp\":\""+timestamp+"\",\"serverIP\":\""+ip+"\" “+ext+" }"; String content=RSAUtils.encryptByPrivateKey(dataStr, privateKey); ``` 2. 前端 后台返回给前端加密后的content,然后发送请求调用 http://xxxxx/ivci/api/vehicle/getScore?merchantId=100000&content=content **返回数据** 返回数据统一都是json格式 ```json {"code":0,"msg":"操作失败","data":""} ``` |参数名称|类型|说明|备注| |:---- |:---|:----- |----- | |code| String| 操作结果码(成功=0,失败=1),见附录1 | 返回| |msg| String| 操作返回信息(一般操作成功,返回null,失败的操作,才返回提示信息) | | |data| json| 富媒体信息,当resType=html时,为字符换,当resType=json,为json对象 | 返回| Data数据格式,如下: ```javascript "data":[{ time:1020,//间隔时长,单位秒 mileage:2.43,//单位千米 endTime:"2017-09-19 00:00:00", endLocation:"广东省深圳市福田区石厦北一街(距彩票销售店87米)" score:95, startTime:"2017-09-19 01:00:00", startLocation:"广东省深圳市福田区福强路2008-1号(距鹏瑞商旅航空售票处57米)", driverName: "Driver-16", plateNo:"粤B632541", oil:0 }] ```