创建车队长

请求地址

https://www.xxyb.cn/union/api/wlpt/consignor/createLeader

Header

参数名	必选	类型	说明
Token	是	string	应用令牌
cid	是	string	合作ID

请求参数

参数名	必选	类型	层级	说明	备注
leaderBasicDomain	是	object	1	车队长基础信息
leaderName	是	string	2	车队长姓名
leaderPhone	是	string	2	车队长手机号
leaderIdCard	是	string	2	身份证号
leaderIdCardAddress	否	string	2	身份证地址
idCardFrontImg	是	string	2	身份证人像面图片
idCardBackImg	是	string	2	身份证国徽面图片
idCardIssuingTime	是	string	2	身份证签发时间
idCardExpireTime	是	string	2	身份证有效期

入参示例

{
  "leaderBasicDomain": {
    "leaderName": "张三",
    "leaderPhone": "13800138000",
    "leaderIdCard": "410181198107110012",
    "leaderIdCardAddress": "河南省郑州市金水区",
    "idCardFrontImg": "https://example.com/idcard_front.jpg",
    "idCardBackImg": "https://example.com/idcard_back.jpg",
    "idCardIssuingTime": "2001-07-11",
    "idCardExpireTime": "长期"
  }
}

入参对象

@Setter
@Getter
@Schema(description = "创建车队长")
public class ApiConsignorLeaderCreateReq {

    @Schema(description = "车队长基础信息")
    @Valid
    @NotNull(message = "车队长基础信息不能为空")
    private ApiLeaderBasicDomain leaderBasicDomain;

    @Setter
    @Getter
    @Accessors(chain = true)
    @Schema(description = "车队长基础信息")
    public class ApiLeaderBasicDomain {

        @Schema(description = "车队长姓名", example = "张三 | 尼古拉斯·赵四")
        @NotBlank(message = "车队长姓名不能为空")
        @Pattern(regexp = "^[\u2E80-\u9FFF·]{2,60}$", message = "车队长姓名格式错误")
        private String leaderName;

        @Schema(description = "车队长手机号", example = "13800000000")
        @NotBlank(message = "车队长手机号不能为空")
        @Pattern(regexp = "^1[3-9]\\d{9}$", message = "车队长手机号格式错误")
        private String leaderPhone;

        @Schema(description = "身份证号", example = "410181198107110012")
        @NotBlank(message = "身份证号不能为空")
        @Pattern(regexp = "[1-9]\\d{5}[1-2]\\d{3}((0\\d)|(1[0-2]))(([012]\\d)|3[0-1])\\d{3}(\\d|X|x)", message = "身份证号格式错误")
        private String leaderIdCard;

        @Schema(description = "身份证地址")
        private String leaderIdCardAddress;

        @Schema(description = "身份证人像面图片", example = "https://xx/yy.png")
        @NotBlank(message = "身份证人像面图片不能为空")
        private String idCardFrontImg;

        @Schema(description = "身份证国徽面图片", example = "https://xx/yy.png")
        @NotBlank(message = "身份证国徽面图片不能为空")
        private String idCardBackImg;

        @Schema(description = "身份证签发时间", example = "yyyy-MM-dd")
        @Pattern(regexp = "^\\d{4}-\\d{2}-\\d{2}$", message = "身份证签发时间格式不正确")
        private String idCardIssuingTime;

        @Schema(name = "身份证有效期", example = "yyyy-MM-dd | 长期")
        @NotBlank(message = "身份证有效期不能为空")
        @Pattern(regexp = "^(\\d{4}-\\d{2}-\\d{2})|(长期)$", message = "身份证有效期格式不正确")
        private String idCardExpireTime;

    }

}

返回参数

参数名	类型	层级	说明	备注
code	int	1	状态码
msg	string	1	请求结果
total	int	1	返回总条数
requestId	string	1	请求编号
data	object	1	返回数据
id	string	2	业务数据ID

反参示例

{
  "code": 200,
  "data": {
    "id": "131321321"
  },
  "msg": "业务处理成功",
  "total": null,
  "requestId": "1eb7cb0e"
}

反参对象

@Setter
@Getter
@Schema(description = "创建车队长")
public class ApiConsignorLeaderCreateRes {

    @Schema(description = "业务数据ID")
    private String id;

}