# 发起核验
接口名称:/carrierAudit/add
请求参数
序号 | 层级 | 英文名称 | 中文名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|---|---|---|
1 | 1 | usage | 核验场景 | String | 20 | 是 | 枚举 1:车老板为司机直系亲属 2:挂靠车车老板收款 3:非挂靠车车老板收款 · |
2 | 1 | name | 车老板姓名 | String | 20 | 是 | 1-20 个字符,只允许汉字+少数民族符号 · |
3 | 1 | idCard | 车老板身份证号 | String | 18 | 是 | 18 位数字(末尾允许输入 X),符合身份证号校验算法 |
4 | 1 | phone | 车老板手机号 | String | 20 | 是 | 传入字段需满足 手机号 校验算法 |
5 | 1 | idCardFrontFilename | 车老板身份证正面照 Filename | String | 255 | 否 | 文件名 |
6 | 1 | idCardBackFilename | 车老板身份证背面照 Filename | String | 255 | 否 | 文件名 |
7 | 1 | driverName | 司机姓名 | String | 20 | 否 | 核验场景为1:车老板为司机直系亲属时,必传 |
8 | 1 | driverIdCard | 司机身份证号 | String | 18 | 否 | 核验场景为1:车老板为司机直系亲属时,必传 |
9 | 1 | driverIdCardFrontFilename | 司机身份证正面照 Filename | String | 255 | 否 | 文件名 |
10 | 1 | driverIdCardBackFilename | 司机身份证背面照 Filename | String | 255 | 否 | 文件名 |
11 | 1 | carLicensePlate | 车牌号 | String | 否 | 核验场景为2:挂靠车车老板收款 或3:非挂靠车车老板收款时,必传 | |
12 | 1 | drivingLicenseFilename | 行驶证主副页照 Filename | String | 255 | 否 | 核验场景为2:挂靠车车老板收款 或3:非挂靠车车老板收款时,必传 |
13 | 1 | attachmentFileUrls | 证明材料 Filename列表,多个文件用“,”隔开 | String | 最多支持9个文件 | 否 | 核验场景为1:车老板为司机直系亲属时,必传(双方关系证明(户口本、结婚证或其他可证明双方关系的材料) 核验场景为2:挂靠车车老板收款时,必传(挂靠协议/保单/挂靠费支付凭证/保费支付凭证以及其他可证明车辆所有权的材料) 核验场景为3:非挂靠车车老板收款时,必传(机动车登记证书、其他可证明车辆所有权的材料) |
返回参数
序号 | 英文名称 | 中文名称 | 类型 | 说明 |
---|---|---|---|---|
1 | data | 核验记录id | long | 核验记录id |
mock 数据示例
{
"code": "00000",
"data": 1,
"message": "请求成功"
}
# 更新核验申请
接口名称:/carrierAudit/update
请求参数
序号 | 层级 | 英文名称 | 中文名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|---|---|---|
1 | 1 | id | 核验记录id | int | 是 | ||
2 | 1 | usage | 核验场景 | String | 20 | 是 | 枚举 1:车老板为司机直系亲属 2:挂靠车车老板收款 3:非挂靠车车老板收款 · |
3 | 1 | name | 车老板姓名 | String | 20 | 是 | 1-20 个字符,只允许汉字+少数民族符号 · |
4 | 1 | idCard | 车老板身份证号 | String | 18 | 是 | 18 位数字(末尾允许输入 X),符合身份证号校验算法 |
5 | 1 | phone | 车老板手机号 | String | 20 | 是 | 传入字段需满足 手机号 校验算法 |
6 | 1 | idCardFrontFilename | 车老板身份证正面照 Filename | String | 255 | 否 | 文件名 |
7 | 1 | idCardBackFilename | 车老板身份证背面照 Filename | String | 255 | 否 | 文件名 |
8 | 1 | driverName | 司机姓名 | String | 20 | 否 | 核验场景为1:车老板为司机直系亲属时,必传 |
9 | 1 | driverIdCard | 司机身份证号 | String | 18 | 否 | 核验场景为1:车老板为司机直系亲属时,必传 |
10 | 1 | driverIdCardFrontFilename | 司机身份证正面照 Filename | String | 255 | 否 | 文件名 |
11 | 1 | driverIdCardBackFilename | 司机身份证背面照 Filename | String | 255 | 否 | 文件名 |
12 | 1 | carLicensePlate | 车牌号 | String | 否 | 核验场景为2:挂靠车车老板收款 或3:非挂靠车车老板收款时,必传 | |
13 | 1 | drivingLicenseFilename | 行驶证主副页照 Filename | String | 255 | 否 | 核验场景为2:挂靠车车老板收款 或3:非挂靠车车老板收款时,必传 |
14 | 1 | attachmentFileUrls | 证明材料 Filename列表,多个文件用“,”隔开 | String | 最多支持9个文件 | 否 | 核验场景为1:车老板为司机直系亲属时,必传(双方关系证明(户口本、结婚证或其他可证明双方关系的材料) 核验场景为2:挂靠车车老板收款时,必传(挂靠协议/保单/挂靠费支付凭证/保费支付凭证以及其他可证明车辆所有权的材料) 核验场景为3:非挂靠车车老板收款时,必传(机动车登记证书、其他可证明车辆所有权的材料) |
返回参数
序号 | 英文名称 | 中文名称 | 类型 | 说明 |
---|
mock 数据示例
{
"code": "00000",
"data": true,
"message": "请求成功"
}
# 查询核验结果
接口名称:/carrierAudit/get
请求参数
序号 | 层级 | 英文名称 | 中文名称 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|---|---|---|
1 | 1 | id | 核验记录id | int | 是 |
返回参数
序号 | 英文名称 | 中文名称 | 类型 | 说明 |
---|---|---|---|---|
1 | id | 核验记录id | long | 核验记录id |
2 | status | 核验状态 | String | 0:审核中 1:已通过 2:已驳回 |
3 | remarks | 结果文本 | String | 结果文本 |
mock 数据示例
{
"code": "00000",
"data": {
"id": 12,
"status": 2,
"remarks": "身份证格式不正确"
},
"message": "请求成功"
}
# 核验结果回调通知
1.请求头会携带sign参数,用于鉴权
serviceName : auditCarrierAudit
接口名称:由接入方提供回调地址
请求参数
序号 | 层级 | 英文名称 | 中文名称 | 类型 | 长度 | 是否必填 | 说明 |
---|---|---|---|---|---|---|---|
1 | 1 | serviceName | 服务名 | String | 是 | 核验结果回调通知 | |
2 | 1 | apiId | 接入apiId | String | 是 | 商家企业接入ApiID | |
3 | 1 | id | 核验记录id | long | 是 | ||
4 | 1 | status | 审核结果 | int | 是 | 1-成功, 2-拒绝 | |
5 | 1 | remarks | 结果文本 | String | 否 |
mock 数据示例
{
"apiId": "d1dee71f8aea218b122e8feadde5aad7",
"serviceName": "auditCarrierAudit",
"id": 12,
"status": 2,
"remarks": "55555"
}
返回参数
序号 | 英文名称 | 中文名称 | 类型 | 说明 |
---|---|---|---|---|
1 | code | 结果码 | String | 1-成功 2-失败 |
2 | message | 结果文本 | String | 结果文本 |
mock 数据示例
{
"code": "00000",
"message": "请求成功"
}