该文档已下架,并且不再维护,新文档请参考点击此处
# 获取多个组织架构的成员
只有学校对应用处于开启状态时,应用方才能调通本文档中接口拿到该学校相关数据。
# 请求方法:
POST(application/json)
# 请求地址:
https://uni.weixiao.qq.com/open/cgi-bin/user/orgs-user-list
# 参数说明:
{
"access_token": ACCESS_TOKEN,
"orgs": [10045, 10046],
"page": 1,
"page_size": 5000
}
参数 | 必填 | 说明 |
---|---|---|
access_token | 是 | 学校的权限凭证 |
orgs | 是 | 组织架构id数组 |
page | 否 | 第几页 |
page_size | 否 | 每页数据大小,每页最大数据是5000 |
# 响应说明:
{
"errcode": 0,
"errmsg": "success",
"page": 1, // 仅当进行分页时有
"page_size": 5000, // 仅当进行分页时有
"total": 9800, // 仅当进行分页时有
"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
], // 组织架构(需申请)
"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", // 手机号(需申请)
"expire_at":"2019-12-31 12:00:00",//有效期结束时间
"start_at":"2019-12-31 12:00:00"//有效期开始时间
},
{
"card_number": "1604030127",
"name": "evan2",
"grade": "2016",
"college": "人居环境工程学院",
"profession": " 工程造价",
"class": "1班",
"identity_type": "1",
"identity_title": "经理/总监/部长/本科生...",
"gender": 1,
"organization": [
2,
222,
496
],
"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",
"expire_at":"2019-12-31 12:00:00",
"start_at":"2019-12-31 12:00:00"
}
]
}
参数 | 说明 |
---|---|
errcode | 错误码 |
errmsg | 错误信息 |
page | 第几页 |
page_size | 每一次拉取数据的大小 |
total | 组织架构下的所有学生总数 |
userlist | 成员列表 |
card_number | 学号 |
name | 姓名 |
gender | 性别:0-未知;1-男;2-女 |
grade | 年级 |
college | 学院 |
profession | 专业 |
class | 班级 |
identity_title | 职称 |
expire_at | 有效期结束时间 |
start_at | 有效期开始时间 |
# 错误码
名称 | 解决方案 |
---|---|
40001 | app_key或app_secret不合法 |
40002 | access_token过期 |
40003 | wxcode不合法 |
40005 | access_token无效 |
40006 | ocode不存在 |
40007 | 学号不存在 |
40008 | 权限不足 |
40009 | 参数缺失 |
40010 | 参数错误 |
40018 | 该学校没有开启应用 |