# 搜索成员
只有主体对应用处于开启状态时，应用方才能调通本文档中接口拿到该主体相关数据。
# 字段申请地址：
发送需要申请的字段到seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com ， lindayyang@tencent.com ， ronniewan@tencent.com)，申请时需要注明应用名称、应用APPKEY、及应用使用场景
# 请求方法：
POST(application/json)
# 请求地址：
https://open.wecard.qq.com/cgi-bin/user/search?access_token=access_token
# 参数说明：
{
"keywords": "keywords"
}
| 参数 | 必填 | 说明 |
|---|---|---|
| keywords | 是 | 关键词，仅支持电子卡号或姓名的精确搜索 |
| access_token | 是 | 获取应用有效凭证 (opens new window) |
# 响应说明：
{
"errcode": 0,
"errmsg": "success",
"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
], // 角色（需申请）
"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": "经理" //职务
}
]
}
| 参数 | 说明 |
|---|---|
| errcode | 错误码 |
| errmsg | 错误信息 |
| userlist | 成员列表 |
| expire_at | 有效期结束时间 |
| start_at | 有效期开始时间 |
# 错误码
| 名称 | 解决方案 |
|---|---|
| 40001 | app_key或app_secret不合法 |
| 40002 | access_token过期 |
| 40003 | wxcode不合法 |
| 40005 | access_token无效 |
| 40006 | ocode不存在 |
| 40007 | 电子卡号不存在 |
| 40008 | 权限不足 |
| 40009 | 参数缺失 |
| 40010 | 参数错误 |
| 40018 | 该主体没有开启应用 |
# 更新日志
| 日期 | 变更说明 |
| 2019-10-18 | 搜索成员接口 响应返回新增 start_time 有效起始时间字段，将 expire_time的有效期解释更改为 有效结束时间 |
| 2020-05-08 | 新增角色字段 |