新增司机
请求地址
https://www.xxyb.cn/union/api/link/createDriver
Header
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 应用令牌 |
| cid | 是 | string | 合作ID |
注意事项
司机信息非必填字段根据实际系统配置情况填写,请联系平台获取
证件有效期为长期时,填写
长期
请求参数
ApiConsignorDriverCreateReq 创建司机请求
| 字段 | 类型 | 层级 | 描述 | 必填 | 备注 |
|---|---|---|---|---|---|
| driverPhone | String | 1 | 司机手机号 | 是 | |
| driverRealAuthDomain | ApiDriverRealAuthDomain | 1 | 司机基础信息 | 是 | |
| driverAuthDomain | ApiDriverAuthDomain | 1 | 司机认证信息 | 否 |
ApiDriverRealAuthDomain 司机实名认证信息
| 字段 | 类型 | 层级 | 描述 | 必填 | 备注 |
|---|---|---|---|---|---|
| driverName | String | 2 | 司机姓名 | 是 | |
| driverIdCard | String | 2 | 身份证 | 是 | |
| driverIdCardAddress | String | 2 | 身份证地址 | 否 | |
| idCardFrontImg | String | 2 | 身份证人像面图片 | 否 | |
| idCardBackImg | String | 2 | 身份证国徽面图片 | 否 |
ApiDriverAuthDomain 司机认证信息
| 字段 | 类型 | 层级 | 描述 | 必填 | 备注 |
|---|---|---|---|---|---|
| driverLicense | String | 2 | 驾驶证 | 否 | |
| driverLicenseFrontImg | String | 2 | 驾驶证正面图片 | 否 | |
| driverLicenseBackImg | String | 2 | 驾驶证背面图片 | 否 | |
| driverLicenseIssuingAuthority | String | 2 | 驾驶证发证机关 | 否 | |
| driverLicenseExpireStartTime | String | 2 | 驾驶证有效期-起 | 否 | |
| driverLicenseExpireEndTime | String | 2 | 驾驶证有效期-止 | 否 | |
| professionalQualificationCertificate | String | 2 | 从业资格证 | 否 | |
| professionalQualificationCertificateImg | String | 2 | 从业资格证图片 | 否 | |
| professionalQualificationCertificateExpireStartTime | String | 2 | 从业资格证有效期-起 | 否 | |
| professionalQualificationCertificateExpireEndTime | String | 2 | 从业资格证有效期-止 | 否 | |
| approvedDrivingType | ApprovedDrivingTypeEnum | 2 | 准驾车型 | 否 |
请求参数示例
json
{
"driverPhone": "13800138000",
"driverRealAuthDomain": {
"driverName": "张三",
"driverIdCard": "110101199001011234",
"driverIdCardAddress": "北京市朝阳区建国路88号",
"idCardFrontImg": "https://img.example.com/idcard/front.jpg",
"idCardBackImg": "https://img.example.com/idcard/back.jpg"
},
"driverAuthDomain": {
"driverLicense": "110101199001011234",
"driverLicenseFrontImg": "https://img.example.com/license/front.jpg",
"driverLicenseBackImg": "https://img.example.com/license/back.jpg",
"driverLicenseIssuingAuthority": "北京市公安局交通警察支队",
"driverLicenseExpireStartTime": "2020-01-01",
"driverLicenseExpireEndTime": "2030-01-01",
"professionalQualificationCertificate": "PQC20250601001",
"professionalQualificationCertificateImg": "https://img.example.com/qualification/cert.jpg",
"professionalQualificationCertificateExpireStartTime": "2021-06-01",
"professionalQualificationCertificateExpireEndTime": "2027-06-01",
"approvedDrivingType": "A1"
}
}返回参数
| 字段名 | 类型 | 层级 | 描述 |
|---|---|---|---|
| id | String | 1 | 司机ID |
返回参数示例
json
{
"code": 200,
"msg": "业务处理成功",
"data": {
"id": "DRIVER_20250601_001"
},
"requestId": "REQ_20250601_001"
}