接口描述
批量获取成员。
请求方法
POST（application/json）
请求地址
https://open.wecard.qq.com/cgi-bin/user/get-user-by-card-numbers?access_token=access_token
输入参数
参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
access_token | 应用有效凭证 | String | 是 | 通过获取应用有效凭证接口获取 |
card_numbers | 电子卡号数组 | List | 是 | - |
输出参数
参数名称 | 是否必填 | 参数类型 | 示例 | 参数描述 | |
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] | 组织架构（需申请） |
| 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 | 入学年份 |
| |||||
示例
输入示例
{"card_numbers":["REAL4411902"]}
输出示例
{"errcode":0,"errmsg":"ok","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":"经理","school_period":"幼儿园","register_year":"2022"}]}