X-Link API 文档-V4.0.0获取车辆信息
获取用户关联的车辆列表,分页,支持按车辆号查询,该接口只支持管理员用户调用,普通用户用获取用户车辆基本信息获取
请求参数
| 名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| userGuid | integer | 否 | 用户ID ,只有登录为超级管理员时,该用户需要查指定的管理用户的信息 |
| userType | integer | 否 | 用户类型,2:业务管理员(可更改基础资料);3:普通用户;5:车牌号登录 |
| vehicleNo | string | 否 | 车牌号 |
| orgGuids | array(integer) | 否 | 分组ID列表 |
| isUnboundOrg | bool | 否 | 未绑定组织 |
| isUnboundUser | bool | 否未绑定用户 |
响应Data (类型:object)
| 名称 | 类型 | 说明 |
|---|---|---|
| total | integer | 总条数 |
| dataList | array(object) | 车辆信息,查看当前页下面的表1 |
表1:车辆信息
| 字段 | 类型 | 说明 |
|---|---|---|
| guid | integer | 车辆ID |
| adminGuid | integer | 管理员ID 管理员为自己的ID |
| createTime | string | 创建时间 |
| updateTime | string | 更新时间 |
| vehicleNo | string | 车牌号 |
| vehicleNoColor | integer | 车牌颜色 |
| opState | bool | 运营状态,true:运营,false,非运营 |
| deviceNo | string | 终端号 |
| password | string | 密码,车辆登录密码 |
| orgGuid | integer | 组织id |
| mileageRatio | integer | 里程系数 1/100 |
| note | string | 备注 |
| iconID | integer | 车辆图标 |
| deadlineTime | integer | 服务到期时间,UTC时间戳 |
| installDate | integer | 安装日期 |
| industryType | integer | 运输行业 -参考前端定义 |
| vehicleWeight | integer | 车辆吨位 |
| vehicleType | integer | 车辆类型 0:其它;1:平板车;2:拖吊车;3:落地平板车;4:防撞车;5:厢式车;91:地库拖车;92:叉车拖车 |
示例
请求示例
json
http://localhost:8080/basic_api/v1/vehicle/get_list
{
"userGuid":1,
"userType":1,
"vehicleNo":"1300212000",
"orgGuids":[1],
"isUnboundOrg":true,
"isUnboundUser":true
}http://localhost:8080/basic_api/v1/vehicle/get_list
{
"userGuid":1,
"userType":1,
"vehicleNo":"1300212000",
"orgGuids":[1],
"isUnboundOrg":true,
"isUnboundUser":true
}响应示例
json
{
"hdr":{
"code":200,
"message":"success" //
},
"data":{
"total":1,
"dataList":[
{
"guid":1,
"adminGuid":1,
"createTime":"2023-11-01 12:12:12",
"updateTime":"2023-11-01 12:12:12",
"vehicleNo":"测A00001",
"vehicleNoColor":2,
"opState":true,
"deviceNo":"13000001",
"password":"",
"orgGuid":1,
"mileageRatio":102, //1.02倍
"note":"",
"iconID":1,
"deadlineTime":1566600015,
"installDate":156655552,
"industryType":1,
"vehicleWeight":1,
"vehicleType":0
}]
}
}{
"hdr":{
"code":200,
"message":"success" //
},
"data":{
"total":1,
"dataList":[
{
"guid":1,
"adminGuid":1,
"createTime":"2023-11-01 12:12:12",
"updateTime":"2023-11-01 12:12:12",
"vehicleNo":"测A00001",
"vehicleNoColor":2,
"opState":true,
"deviceNo":"13000001",
"password":"",
"orgGuid":1,
"mileageRatio":102, //1.02倍
"note":"",
"iconID":1,
"deadlineTime":1566600015,
"installDate":156655552,
"industryType":1,
"vehicleWeight":1,
"vehicleType":0
}]
}
}