# 司机/车辆信息核验接口文档

## 一、接口规范

### 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