76 lines
4.0 KiB
Markdown
76 lines
4.0 KiB
Markdown
# 司机/车辆信息核验接口文档
|
||
|
||
## 一、接口规范
|
||
|
||
### 1.1 信息提交接口（服务商→中道）
|
||
|
||
**接口地址**: `/provider/driver-info`
|
||
**请求方式**: POST
|
||
**Content-Type**: application/json
|
||
|
||
#### 请求参数说明：
|
||
|
||
| 参数名 | 必填 | 类型 | 说明 |
|
||
|----------------------|------|--------|--------------------------------------------------------------------|
|
||
| providerCode | 是 | String | 服务商编码（由中道分配） |
|
||
| operateType | 是 | String | 操作类型：1-新增 2-修改 3-停用 |
|
||
| rescueNo | 是 | String | 救援师傅工号（唯一标识） |
|
||
| rescueName | 是 | String | 师傅姓名 |
|
||
| rescuePhone | 是 | String | 师傅联系电话 |
|
||
| sex | 是 | String | 性别：0-女 1-男 |
|
||
| identity | 是 | String | 身份证号码 |
|
||
| nonMotorVehicle | 是 | String | 是否非机动车驾驶员：1-是 0-否（选1时驾照相关字段可不填） |
|
||
| identityPhoto_1 | 是 | String | 身份证正面照片URL |
|
||
| identityPhoto_2 | 是 | String | 身份证反面照片URL |
|
||
| licenseType | 否 | String | 驾照类型（A1/A2/A3/B1/B2/C1/C2） |
|
||
| licenseStartDay | 否 | String | 驾照领证时间（格式：yyyy-MM-dd） |
|
||
| licenseEndDay | 否 | String | 驾照失效时间（格式：yyyy-MM-dd） |
|
||
| LicensePhoto | 否 | String | 驾照照片URL |
|
||
| rescuePersonPhoto | 否 | String | 师傅正面照URL |
|
||
| belongType | 是 | String | 归属类型：1-自有师傅 0-外协师傅 |
|
||
| timestamp | 是 | String | 请求时间戳（格式：yyyy-MM-dd HH:mm:ss） |
|
||
|
||
### 1.2 核验通知接口（中道→服务商）
|
||
|
||
**回调地址**: 需服务商提前配置
|
||
**通知方式**: POST
|
||
**Content-Type**: application/json
|
||
|
||
#### 通知参数说明：
|
||
|
||
| 参数名 | 必填 | 类型 | 说明 |
|
||
|---------------|------|--------|--------------------------------------|
|
||
| providerCode | 是 | String | 服务商编码 |
|
||
| rescueNo | 是 | String | 救援工号 |
|
||
| status | 是 | String | 核验状态：certifying/fail/success/expired |
|
||
| timestamp | 是 | String | 状态变更时间（格式同上） |
|
||
| remark | 否 | String | 失败原因说明 |
|
||
|
||
## 二、业务流程
|
||
|
||
```mermaid
|
||
sequenceDiagram
|
||
participant 服务商系统
|
||
participant 中道系统
|
||
|
||
服务商系统->>中道系统: 提交司机信息（/provider/driver-info）
|
||
中道系统-->>服务商系统: 返回受理结果
|
||
|
||
alt 数据校验失败
|
||
中道系统-->>服务商系统: code=2001
|
||
else 校验通过
|
||
中道系统->>中道系统: 状态变更为「认证中」
|
||
|
||
loop 核验流程
|
||
中道系统->>中道系统: 人工审核/系统核验
|
||
end
|
||
|
||
中道系统->>服务商系统: POST核验通知（/provider/verification-notify）
|
||
|
||
alt 核验成功
|
||
服务商系统->>服务商系统: 锁定认证字段
|
||
else 核验失败/过期
|
||
服务商系统->>服务商系统: 开放对应修改权限
|
||
end
|
||
end
|