新增货主
请求地址
https://www.xxyb.cn/union/api/link/createOwner
Header
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | String | 应用令牌 |
| cid | 是 | String | 合作ID |
请求参数
| 参数名 | 类型 | 层级 | 描述 | 必填 |
|---|---|---|---|---|
| ownerPhone | String | 1 | 货主手机号 | 是 |
| ownerAuthDomain | ApiOwnerAuthDomain | 1 | 货主认证信息 | 是 |
ApiOwnerAuthDomain 货主认证信息
| 字段 | 类型 | 层级 | 描述 | 必填 |
|---|---|---|---|---|
| businessLicense | String | 2 | 营业执照URL | 是 |
| enterpriseName | String | 2 | 企业名称 | 是 |
| creditCode | String | 2 | 统一社会信用代码 | 是 |
| enterpriseType | String | 2 | 企业类型 | 是 |
| enterpriseAddr | String | 2 | 注册地址 | 是 |
| registeredCapital | Decimal | 2 | 注册资本(万元) | 是 |
| periodValidity | String | 2 | 营业执照有效期至 | 是 |
| businessScope | String | 2 | 经营范围 | 是 |
| corporateIdCardFront | String | 2 | 法人身份证人像面URL | 是 |
| corporateIdCardBack | String | 2 | 法人身份证国徽面URL | 是 |
| corporateName | String | 2 | 法人姓名 | 是 |
| corporateIdCardNumber | String | 2 | 法人身份证号 | 是 |
| corporateIdCardValidityBegin | String | 2 | 法人身份证有效期起 | 是 |
| corporateIdCardValidityEnd | String | 2 | 法人身份证有效期至 | 是 |
| contactName | String | 2 | 联系人姓名 | 是 |
| contactMobile | String | 2 | 联系方式不能为空 | 是 |
| contactEmail | String | 2 | 联系人邮箱 | 否 |
入参示例
json
{
"ownerPhone": "13800138000",
"ownerAuthDomain": {
"businessLicense": "https://example.com/business_license.pdf",
"enterpriseName": "北京科技有限公司",
"creditCode": "91110105MA00123456",
"enterpriseType": "有限责任公司",
"enterpriseAddr": "北京市海淀区中关村大街1号",
"registeredCapital": 1000.00,
"periodValidity": "长期",
"businessScope": "技术开发、技术咨询、技术服务、技术转让;计算机系统服务;数据处理;基础软件服务;应用软件服务;软件开发;软件咨询;软件维护;软件测试;计算机维修;计算机系统集成;销售计算机、软件及辅助设备;货物进出口;技术进出口;代理进出口。",
"corporateIdCardFront": "https://example.com/corporate_id_card_front.jpg",
"corporateIdCardBack": "https://example.com/corporate_id_card_back.jpg",
"corporateName": "张三",
"corporateIdCardNumber": "410181198107110012",
"corporateIdCardValidityBegin": "2001-07-11",
"corporateIdCardValidityEnd": "长期",
"contactName": "李四",
"contactMobile": "13900139000",
"contactEmail": "lisi@example.com"
}
}返回参数
| 参数名 | 类型 | 层级 | 说明 | 备注 |
|---|---|---|---|---|
| id | String | 1 | 货主ID | |
| authStatus | AuthStatusEnum | 1 | 认证状态 |
反参示例
json
{
"code": 200,
"data": {
"id": "131321321",
"authStatus": "WAIT"
},
"msg": "业务处理成功",
"total": null,
"requestId": "1eb7cb0e"
}