批量获取成员

接口描述

批量获取成员

请求方法

POST(application/json)

请求地址

https://open.wecard.qq.com/cgi-bin/user/get-user-by-card-numbers?access_token=access_token

参数说明

{
        "card_numbers": ["REAL4411902"]
}

参数	必填	类型	实例	说明
access_token	是	String		应用凭证
card_numbers	是	Json		电子卡号数组，转成Json

响应说明（分行业用户字段说明）

{
	"errcode": 0,
	"errmsg": "ok",
	"userlist": [{
            "card_number": "1604030126", // 电子卡号
            "name": "evan1", // (需申请)姓名
            "identity_type": "1", // (需申请)身份类型，1为其他，2为学生，3为教职工，4为校友
            "grade": "2016", // 年级(仅限自建应用）
            "college": "人居环境工程学院", // 学院(仅限自建应用）
            "profession": " 工程造价", // 专业(仅限自建应用）
            "class": "1班", // 班级(仅限自建应用）
            "identity_title": "经理/总监/部长/本科生...", // 身份职称(仅限自建应用）
            "gender": 1, // 性别(仅限自建应用）
            "organization": [
                2,
                222,
                496
            ], // 组织架构(仅限自建应用）
            "role": [
                1,
                2
            ], // 角色(仅限自建应用）
            "main_org_node": 2,
            "campus": "东校区", // 校区(仅限自建应用）
            "dorm_number": "至善园", // 宿舍号(仅限自建应用）
            "physical_chip_number": "", // 物理芯片号(仅限自建应用）
            "physical_card_number": "", // 物理卡号(仅限自建应用）
            "nation": "汉族", // 民族(仅限自建应用）
            "birthday": "20020319", // 生日(仅限自建应用）
            "origin_place": "深圳市", // 生源地(仅限自建应用）
            "graduated_school": "小碧中学", // 毕业学校(仅限自建应用）
            "address": "广东省深圳市XXX", // 家庭住址(仅限自建应用）
            "contact_person": "", // 联系人(仅限自建应用）
            "contact_phone": "", // 联系人手机号(仅限自建应用）
            "email": "xxxxx@qq.com", // 邮箱(仅限自建应用）
            "id_card": "440XXXXXXXXXXXXXXX", // 身份证(仅限自建应用）
            "telephone": "137XXXXXXXX", // 手机号(仅限自建应用）
            "bind_status": 0, //绑定状态(需申请)
            "frozen_status": 0, //冻结状态(需申请)
            "active_status": 0, //激活状态(需申请)
            "entrust_status": 0, //签约状态(需申请)0-未签约，1-已签约
            "expire_at": "2019-12-31 12:00:00", //有效期结束时间
            "start_at": "2019-12-31 12:00:00", //有效期开始时间
            "head_image":"https://xxxxxxxxxxxxxx/a.png", //头像
            "serial_number": "19527123", //编号
            "job_title": "经理", //职务
            "school_period": "幼儿园",  //学段
            "register_year": "2022" //入学年份
	}]
}

参数		必填	类型	实例	说明
errcode		是	Integer	0	状态码，0为成功，非0为错误
errmsg		是	String	success	状态描述信息
userlist	name	是	String	XXX	用户姓名(需申请)
	card_number	是	Integer	REAL4411902	用户电子卡号/学工号
	identity_type	是	Integer	0	身份类型id(需申请)
	grade	是	String	XXX	年级(仅限自建应用)
	college	是	Integer	REAL4411902	学院(仅限自建应用)
	profession	是	Integer	0	专业(仅限自建应用)
	class	是	String	XXX	班级(仅限自建应用)
	identity_title	否	Integer	REAL4411902	身份职称(仅限自建应用)
	gender	是	Integer	1	性别，0为未知，1为男，2为女(仅限自建应用)
	organization	是	json	[2,222,246]	组织架构(需申请)
	main_org_node	否	Integer	2	用户主部门 id，若无主部门则为 0
	role	是	json	[1,1]]	角色(仅限自建应用)
	campus	是	String	东校区	校区(仅限自建应用）
	dorm_number	是	String	至善园	宿舍号(仅限自建应用）
	physical_chip_number	是	Integer		物理芯片号(需申请)
	physical_card_number	是	Integer	0	物理卡号(需申请)
	nation	是	String	"汉族"	民族(仅限自建应用）
	birthday	是	Integer	20020319	生日(仅限自建应用）
	origin_place	是	Integer	深圳市	生源地(仅限自建应用）
	graduated_school	是	String	小碧中学	毕业学校(仅限自建应用）
	address	是	String	广东省深圳市XXX	家庭住址(仅限自建应用）
	contact_person	是	String		联系人(仅限自建应用）
	contact_phone	是	String		联系人手机号(仅限自建应用）
	email	是	String	xxxxx@qq.com	邮箱(仅限自建应用）
	id_card	是	Integer	440XXXXXXXXXXXXXXX	身份证(仅限自建应用）
	telephone	是	String	137XXXXXXXX	手机号(仅限自建应用）
	bind_status	是	Integer	0	绑定状态(需申请)
	frozen_status	是	Integer	0	冻结状态(需申请)
	active_status	是	Integer	0	激活状态(需申请)
	entrust_status	是	Integer	0	签约状态(需申请)0-未签约，1-已签约
	expire_at	是	Integer	0	有效期结束时间
	start_at	是	Integer	0	有效期开始时间
	head_image	否	String	https://xxxxxxxxxxxxxx/a.png	用户头像(仅限自建应用)
	serial_number	否	String	19527123	编号(仅限自建应用)
	job_title	否	String	经理	职务(仅限自建应用)
	school_period	否	String	幼儿园	学段
	register_year	否	int	2022	入学年份