API开发文档 - 杏盛注册

开发说明

开发说明

功能说明：新增用户
请求方式：POST（HTTPS）multipart/form-data
请求地址：http://qwif.hbrhdl.com/qwcgi/api/userAPI/addUser.do?token=token&corpId=corpId

请求包体：

{
	"address":"上海市天河区",
	"attribute":"0",
	"birthday":"1999-10-12",
	"departmentId":"5effccf0f7d3987aea0ca4a698ade9ba",
	"email":"daoyi11@qq.com",
	"entryTime":"2018-12-12",
	"gender":"1",
	"identity":"44522419950401432X",
	"isLeader":"1",
	"listJson":
	{
		"list":
		[
			{
				"content":"上海员村",
				"optionId":"082a0260688f4402967e41de22af4d00"
			},
			{
				"content":"2019-05-23",
				"optionId":"ff5f6ad211cf4ae2a471649205d4ecc0"
			}

		]

	},
	"lunarCalendar":"09-01",
	"mark":"备注说明",
	"mobile":"13090000000",
	"name":"张三",
	"nickName":"小明",
	"position":"经理",
	"qq":"10000",
	"remindType":"1",
	"sort":"1000",
	"tel":"0968-123456",
	"tel2":"021-88886666",
	"userNo":"1302313",
	"weixinNum":"name12",
	"wxUserId":"zhangsan"
}

请求参数说明：

参数	说明	类型	是否必须	备注
token	用于验证	String	是
corpId	公司唯一标识	String	是
name	用户名称	String	是
departmentId	部门id	String	是
position	职位	String	否
mobile	手机号码	String	否	手机号，微信号，邮箱三者不可同时为空
gender	性别（1，男；2，女）	String	否	不传默认为1
tel	座机	String	否	由纯数字或“-”号组成，最多不超过30个字符
tel2	座机2	String	否	由纯数字或“-”号组成，最多不超过30个字符
email	邮箱	String	否	手机号，微信号，邮箱三者不可同时为空
qq	QQ号码	String	否
weixinNum	微信号	String	否	手机号，微信号，邮箱三者不可同时为空
wxUserId	微信用户Id	String	否
birthday	阳历生日	String	否	格式：yyyy-MM-dd
entryTime	入职时间	String	否	格式：yyyy-MM-dd
attribute	成员类型	整数	否	0表示普通用户，1表示家长，2表示教师/职工，3表示学生。默认为普通用户
identity	身份证	String	否	15位或18位身份证号
nickName	昵称	String	否	可在新闻公告应用的生日祝福等场景使用，最多不超过50个字符
sort	排序	整数	否	按从小到大排序，最大不超过100000000，默认为100000
userNo	用户编号	String	否	需要唯一，支持数字、字母，标点符号支持“-”“.”，最多不超过36个字符
isLeader	身份	整数	否	表示在所在的部门内是否为上级。1表示是，0表示否，默认为否
address	地址	String	否	最多不超过200个字符
lunarCalendar	农历生日	String	否	例如：09-18表示农历九月十八
remindType	生日祝福提醒	String	否	0表示农历，1表示阳历
mark	备注	String	否	最多不超过4000个字符
listJson	自定义字段json	String	否	自定义字段json
optionId	人员自定字段optionId	String	否	自定义字段optionid
content	自定义字需要填入的段值	String	否	自定义字段值

SDK调用示例：

        InterfaceUser user = new InterfaceUser();
        //用户名称
        user.setName("张三");
        //部门ID
        user.setDepartmentId("03263e813a7801d41a7ccff9fc319331");
        //职位
        user.setPosition("经理");
        //手机号码  手机号，微信号，邮箱三者不可同时为空
        user.setMobile("13012365523");
        //性别（1，男；2，女） 默认为1
        user.setGender("1");
        //电话
        user.setTel("0968-123456");
        //邮箱  手机号，微信号，邮箱三者不可同时为空
        user.setEmail("daoyiyun543@qq.com");
        //QQ号码
        user.setQq("10000");
        //微信号  手机号，微信号，邮箱三者不可同时为空
        user.setWeixinNum("name12ss");
        //阳历生日
        user.setBirthday("1999-10-12");
        //入职时间
        user.setEntryTime("2018-12-12");
        //wxUserId
        user.setWxUserId("wxn3213123");
        //成员类型
        user.setAttribute(0);
        //身份证
        user.setIdentity("44522419950401432X");
        //昵称
        user.setNickName("小明");
        //排序值
        user.setSort(1000);
        //用户编号
        user.setUserNo("1231213");
        //身份
        user.setIsLeader(1);
        //座机2
        user.setTel2("021-88886366");
        //地址
        user.setAddress("上海市天河区");
        //农历生日
        user.setLunarCalendar("09-01");
        //生日祝福提醒
        user.setRemindType("1");
        //备注
        user.setMark("备注说明");

        //设置自定义字段信息
        UserListJsonVo userListJsonVo = JSONUtil.stringToObject("{\"list\":[{\"optionId\":\"082a0260688f4402967e41de22af4d00\",\"content\":\"上海员村\"},{\"optionId\":\"ff5f6ad211cf4ae2a471649205d4ecc0\",\"content\":\"2019-05-23\"}]}",
                UserListJsonVo.class);
        user.setListJson(userListJsonVo);

        UserApi api = QwSdkUtil.getInter(UserApi.class);
        ApiUserResultVO result = api.addUser(QwSdkUtil.getCacheToken(),user);
        System.out.println(JSONUtil.stringify(result));

返回结果：

{
	"code":"0",
	"data":
	{
		"user":
		{
			"address":"上海市天河区",
			"attribute":0,
			"birthday":"1999-10-12",
			"departmentId":"03263e813a7801d41a7ccff9fc319331",
			"email":"daoyiyun543@qq.com",
			"entryTime":"2018-12-12",
			"gender":"1",
			"headPic":"0",
			"identity":"44522419950401432X",
			"isLeader":1,
			"listJson":
			{
				"list":
				[
					{
						"content":"2019-05-23",
						"id":"505be59bbbac46ef88119eee61c32186",
						"optionId":"ff5f6ad211cf4ae2a471649205d4ecc0",
						"orgId":"02f5ca343129495bad85d162d2bd5b34",
						"userId":"6e53cc3431996f5a3bdbcd280f2954fc"
					},
					{
						"content":"上海员村",
						"id":"3c0afa85d5e24820af6f78b67c8e4b57",
						"optionId":"082a0260688f4402967e41de22af4d00",
						"orgId":"02f5ca343129495bad85d162d2bd5b34",
						"userId":"6e53cc3431996f5a3bdbcd280f2954fc"
					}

				]

			},
			"lunarCalendar":"09-01",
			"mark":"备注说明",
			"mobile":"13012365523",
			"name":"张三",
			"nickName":"小明",
			"position":"经理",
			"qq":"10000",
			"remindType":"1",
			"sort":1000,
			"tel":"0968-123456",
			"tel2":"021-88886366",
			"userId":"6e53cc3431996f5a3bdbcd280f2954fc",
			"userNo":"1231213",
			"userStatus":"0",
			"weixinNum":"name12ss",
			"wxUserId":"wxn3213123"
		}

	},
	"desc":"成功"
}

返回参数说明：

参数	说明
userId	用户ID
organId	组织编号
userStatus	用户状态
followTime	关注时间
headPic	用户头像
name	用户名称
departmentId	部门id
position	职位
mobile	手机号码
gender	性别（1，男；2，女）
tel	座机
tel2	座机2
email	邮箱
qq	QQ号码
weixinNum	微信号
wxUserId	微信用户Id
birthday	阳历生日
entryTime	入职时间
attribute	成员类型
identity	身份证
nickName	昵称
sort	排序
userNo	用户编号
isLeader	身份
address	地址
lunarCalendar	农历生日
remindType	生日祝福提醒
mark	备注
listJson	自定义字段json字符串
list	自定义字段json集合
id	唯一ID
optionId	人员自定义字段ID
content	自定义字需要填入的段值
orgId	机构ID
userId	杏盛注册用户ID

企业微信

新增用户

开发说明