chainwaytsp

**Request address：** 
- `/ivci/api/vehicle/getVehicleById`
  
**Request mode：**
- POST,GET

**Parameter description**

|Parameter name|Type|Description|Remark|
|:----    |:---|:----- |-----   |
|content |String  |Requested encrypted data |Mandatory   |
|merchantId |String  |Customer name of the request user | Mandatory    |

**Remark** 
Content is decrypted into json format via RSA
```
{
"userName":"testuser",
"antiFake":"4bbab6ff0d8042548cc6f2df9f3655fa",
"timestamp":"20160518165030",
"serverIP":"127.0.0.1",
"queryVehicle":{
"vehicleId":123
}
}
```

**Content parameter description**

|Parameter name|Type|Description|Remark|
|:----    |:---|:----- |-----   |
|userName |   String | User name| Mandatory|
|antiFake |   String | Anti-fake random string  | Mandatory|
|timestamp |  String|  Request time stamp,accurate to second|  Mandatory|
|serverIP |   String | Server IP  | Mandatory|
|queryVehicle |   json   | Query vehicle info | Mandatory|
|queryVehicle.vehicleId|  int| Query vehicle ID|  Mandatory|

**Use exampless：**
1. Backend
```java
//read privateKeyStr
String privateKey=...........
//get digital signature
SimpleDateFormat  formatter = new SimpleDateFormat ("yyyyMMddHHmmss");
String timestamp=formatter.format(new Date());
String signStr=RSAUtils.sign(timestamp.getBytes(), privateKey);
String ip=request.getRemoteAddr();
//encrypted with private key
String ext=",\"queryVehicle\":{.............}";//assemble vehicle info
String dataStr="{\"userName\":\"testuser\",\"antiFake\":\""+signStr+"\",\"timestamp\":\""+timestamp+"\",\"serverIP\":\""+ip+"\" "+ext+" }";
String content=RSAUtils.encryptByPrivateKey(dataStr, privateKey);
```

2. Front end
The backend return the encrypted content to the front end, and then send the request calling. 
http://xxxxx/ivci/api/vehicle/getVehicleById?merchantId=100000&content=content

**Return data**
All return data should be in json format 
```json
{"code":0,"msg":"operate failed","data":{}}
```

**Return parameter**
 
|Parameter name|type|description|remark|
|:----    |:---|:----- |-----   |
|code|    String |Operate result code(success=0,failed=1, refer to appendix 1 |  Mandatory|
|msg| String| Operate return information（Operate succeed，return null；operate failed，return prompt information）|&nbsp;|
|data   | json |&nbsp;|&nbsp;|

**Return vehicle info data**

|Parameter name|type|description|remark|
|:----    |:---|:----- |-----   |
|annualVerificationDate | String | Annual inspection period|  &nbsp;|
|approveMass |String | Vehicle loading mass|    &nbsp;|
|brand |  String | Branch|  &nbsp;|
|burningType |String | Form of fuel|    &nbsp;|
|buyTime |date |   Purchase date|    &nbsp;|
|carColor |   String | Vehicle color|    &nbsp;|
|carEngine |  String | Engine number|    &nbsp;|
|carPhoto |   String | Vehicle photos|    &nbsp;|
|carStatus |  Int |Vehicle status|    &nbsp;|
|carVim | String | Vehicle frame number| &nbsp;|
|companyId |  Integer |subordinate companies Id(same as deptId) |&nbsp;|
|containerSize |  String | Container size|    &nbsp;|
|createBy |   Int |Creator| &nbsp;|
|createTime | date |   Create date|    &nbsp;|
|defaultFue | String | Default energy|    &nbsp;|
|deptId | Int |Department Id|  &nbsp;|
|deptName |   String | Department name|  &nbsp;|
|drawMass |   Double | Total traction weight|   &nbsp;|
|driverId |   Int |Driver id|   &nbsp;|
|driverName | String | Driver name|   &nbsp;|
|driverCount |Int |Number of drivers|   &nbsp;|
|drivingLicensePhoto |String | Driver's license photo|   &nbsp;|
|engineDisplacement | String | Engine capacity|   &nbsp;|
|equipmentPn |String | Bind device PN|  &nbsp;|
|equipmentSn |String | Bind device SN|  &nbsp;|
|equipmentVersion |   String | Bind device version|  &nbsp;|
|fueGrade |   String | Energy labeling|    &nbsp;|
|gmtZone |String | Time zone|  &nbsp;|
|imgType |String | Image type|    &nbsp;|
|inspectionPeriod |   String | Annual inspection period |    &nbsp;|
|insuranceClaimsPhone |   String | Claims phone number|    &nbsp;|
|insuranceCompany |   String | Insurance company|    &nbsp;|
|insuranceEffectTime |Date |   Effective date of the policy|  &nbsp;|
|insuranceExpense |   Double | Insurance policy number|    &nbsp;|
|insuranceNo |String | Insurance No.|    &nbsp;|
|insurancePeriod |Double | Insurance period|    &nbsp;|
|isDel |  Int |Delete or not|    &nbsp;|
|licenseNo |  String | Driver licence No.|    &nbsp;|
|metermileage |   Double | Vehicle mileage|    &nbsp;|
|models | String | Vehicle type|  &nbsp;|
|modelsName | String | Vehicle mode name|    &nbsp;|
|oilpermile | Double | Fuel consumption per one hundred kilometer|   &nbsp;|
|operationLicensePhoto |  String | Vehicle operation manual photo|    &nbsp;|
|outFacTime | Date |   Date of manufacture|    &nbsp;|
|plateNo |String | Plate number| &nbsp;|
|price |  Double | Vehicle price，unit/$|    &nbsp;|
|tireNum |int |Total number of tires|    &nbsp;|
|tireSize |   String | Tire specification|    &nbsp;|
|totalMass |  Double | Total mass| &nbsp;|
|updateUser | Int |Update user id|  &nbsp;|
|vehicleId |  Int |Vehicle id|    &nbsp;|
|verandaSize |String | Veranda size，format：length,width,height  |&nbsp;|
|vichcleType |String | Vehicle category|    &nbsp;|
|wheelbase |  Int |Wheelbase|  &nbsp;|

Return data need to be decoded, the decryption process is as follows：
```java
String key="......";
String mi="56D56B912C68308AA6D863DE087DBFD82D65C37836FC15E0B92";
String ming=RSAUtils.decryptByPrivateKey(mi, key);
```

3.17Query vehicle