接口描述
批量获取成员。
请求方法
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"}]}
?