sa-charts/docker-compose-3.129/test.md

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

一、接口规范

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	失败原因说明

二、业务流程

sequenceDiagram
    participant 服务商系统
    participant 中道系统
    
    服务商系统->>中道系统: 提交司机信息（/provider/driver-info）
    中道系统-->>服务商系统: 返回受理结果
    
    alt 数据校验失败
        中道系统-->>服务商系统: code=2001
    else 校验通过
        中道系统->>中道系统: 状态变更为「认证中」
        
        loop 核验流程
            中道系统->>中道系统: 人工审核/系统核验
        end
        
        中道系统->>服务商系统: POST核验通知（/provider/verification-notify）
        
        alt 核验成功
            服务商系统->>服务商系统: 锁定认证字段
        else 核验失败/过期
            服务商系统->>服务商系统: 开放对应修改权限
        end
    end