接口描述
根据相关关键词搜索成员。
注意:
只有主体对应用处于开启状态时,应用方才能调通本文档中接口拿到该主体相关数据。
请求方法
POST(application/json)
请求地址
https://open.wecard.qq.com/cgi-bin/user/search?access_token=access_token
输入参数
参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
access_token | 应用有效凭证 | String | 是 | 通过获取应用有效凭证接口获取 |
keywords | 关键词,仅支持电子卡号或姓名的精确搜索 | String | 是 | - |
输出参数
参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
errcode | 错误码 | Integer | 是 | - |
errmsg | 错误信息 | String | 是 | - |
userlist | 成员列表 | List | 是 | 以下字段均为 userlist 中一个成员的字段 |
card_number | 电子卡号 | String | 是 | - |
name | 姓名 | String | 是 | - |
identity_type | 身份类型 | String | 是 | 1:其他,2:学生,3:教职工,4:校友 |
grade | 年级(需申请) | String | 否 | - |
college | 学院(需申请) | String | 否 | - |
profession | 专业(需申请) | String | 否 | - |
class | 班级(需申请) | String | 否 | - |
identity_title | 身份职称(需申请) | String | 否 | - |
gender | 性别(需申请) | Integer | 否 | - |
organization | 组织架构(需申请) | List | 否 | - |
role | 角色(需申请) | List | 否 | - |
campus | 校区(需申请) | String | 否 | - |
dorm_number | 宿舍号(需申请) | String | 否 | - |
physical_chip_number | 物理芯片号(需申请) | String | 否 | - |
physical_card_number | 物理卡号(需申请) | String | 否 | - |
nation | 民族(需申请) | String | 否 | - |
birthday | 生日(需申请) | String | 否 | - |
origin_place | 生源地(需申请) | String | 否 | - |
graduated_school | 毕业学校(需申请) | String | 否 | - |
address | 家庭住址(需申请) | String | 否 | - |
contact_person | 联系人(需申请) | String | 否 | - |
contact_phone | 联系人手机号(需申请) | String | 否 | - |
email | 邮箱(需申请) | String | 否 | - |
id_card | 身份证(需申请) | String | 否 | - |
telephone | 手机号(需申请) | String | 否 | - |
bind_status | 绑定状态(需申请) | Integer | 否 | - |
frozen_status | 冻结状态(需申请) | Integer | 否 | - |
active_status | 激活状态(需申请) | Integer | 否 | - |
entrust_status | 签约状态(需申请) | Integer | 否 | 0:未签约,1:已签约 |
expire_at | 有效期结束时间 | String | 是 | - |
start_at | 有效期开始时间 | String | 是 | - |
head_image | 头像 | String | 是 | - |
serial_number | 编号 | String | 是 | - |
job_title | 职务 | String | 是 | - |
示例
输入示例
{"keywords": "keywords"}
输出示例
{"errcode":0,"errmsg":"success","userlist":[{"card_number":"1604030126","name":"evan1","identity_type":"1","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,"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":"经理"}]}