货车API接口文档
最近更新时间:2022-08-12
描述
传入车辆发动机型号,查询车辆相关配件参数数据,配件通用号,配件厂家等相关信息。
鉴权校验URL
http://c.c/index/api/check
调用方法
post
请求体格式
multipart/form-data
权限
需要通过鉴权token接口获取token发起该请求
鉴权token校验参数
| 参数名 | 类型 | 参数说明 |
|---|---|---|
| user | string | 用户名 |
| token | string | 鉴权token |
校验返回值说明
| 参数名 | 参数类型 | 参数描述 |
|---|---|---|
| status | string | 200:成功,400:业务异常,401:身份验证失败,402:无权限 |
| access-token | string | 通过此access-token获取下面数据 |
| expire | number | access-token过期时间 |
| message | string | 提示信息 |
数据获取调用URL
http://c.c/index/api/engine
调用方法
post
请求体格式
multipart/form-data
请求参数
常规token调用请求。
| 是否必选 | 参数名 | 类型 | 参数说明 |
|---|---|---|---|
| 必选 | access-token | string | 通过调用获取鉴权接口获得 |
| 必选 | engine | string | 发动机型号 |
返回值说明
| 参数名 | 参数类型 | 参数描述 |
|---|---|---|
| status | string | 200:成功, 400:业务异常 |
| data | 对象集合 | 执行成功时data有对象值,执行异常时不返回data |
| message | string | 提示信息 |
data对象
| 参数名 | 参数类型 | 参数描述 |
|---|---|---|
| oilfilter | Object | 机油滤清器,原厂型号,配件厂家 |
| dieselfilter | Object | 柴油滤清器,原厂型号,配件厂家 |
| oilseparator | Object | 油水分离器,原厂型号,配件厂家 |
| airfilter | Object | 空气滤芯,原厂型号,配件厂家 |
| waterpump | Object | 水泵,原厂型号,配件厂家 |
| blastpump | Object | 打气泵,原厂型号,配件厂家 |
| turbocharger | Object | 涡轮增压器,原厂型号,配件厂家 |
| conditioningbelt | Object | 空调皮带,原厂型号,配件厂家 |
| generatorbelt | Object | 发电机皮带,原厂型号,配件厂家 |
| pumpbelt | Object | 水泵皮带,原厂型号,配件厂家 |
| tensioningwheel | Object | 涨紧轮,原厂型号,配件厂家 |
返回值示例
成功请求返回值示例
{
"status": 200,
"message": "success",
"data": {
"oilfilter": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"dieselfilter": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"oilseparator": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"waterpump": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"airfilter":: {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"blastpump": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"turbocharger": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"conditioningbelt": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"generatorbelt": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"pumpbelt": {part: '配件名称', model: 'ag32266', factory: '配件厂家'},
"tensioningwheel": {part: '配件名称', model: 'ag32266', factory: '配件厂家'}
}
}
ERROR_MESSAGE 错误编码
| HTTP 状态代码 | 错误信息 |
|---|---|
| 400 | 业务异常,具体message提示。 |
| 401 | 身份验证失败(token过期或非法账号) |
| 402 | 未开通产品权限;或者产品次数不足 |
| 403 | 参数不正确 |
| 500 | 系统内部异常 |