# 搜索成员

只有主体对应用处于开启状态时,应用方才能调通本文档中接口拿到该主体相关数据。

# 字段申请地址:

发送需要申请的字段到zhimuli@tencent.com进行申请,申请时需要注明应用名称、应用APPKEY、及应用使用场景

# 请求方法:

POST(application/json)

# 请求地址:

https://open.wecard.qq.com/cgi-bin/user/search?access_token=access_token

# 参数说明:

{
    "keywords": "keywords"
}
参数 必填 说明
keywords 关键词,仅支持电子卡号或姓名的精确搜索
access_token 获取应用有效凭证

# 响应说明:

{
    "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://xxxxxxxxxxxxx/a.png"//头像
        }
    ]
}
参数 说明
errcode 错误码
errmsg 错误信息
userlist 成员列表
expire_at 有效期结束时间
start_at 有效期开始时间

# 错误码

名称 解决方案
40001 app_key或app_secret不合法
40002 access_token过期
40003 wxcode不合法
40005 access_token无效
40006 school_code不存在
40007 电子卡号不存在
40008 权限不足
40009 参数缺失
40010 参数错误
40018 该主体没有开启应用

# 更新日志

日期 变更说明
2019-10-18 搜索成员接口 响应返回新增 start_time 有效起始时间字段,将 expire_time的有效期解释更改为 有效结束时间
2020-05-08 新增角色字段