# 发起核验

接口名称:/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": "请求成功"
 }