该文档已下架，不再进行维护，新文档请参考点击此处
# 获取单个组织架构成员
只有学校对应用处于开启状态时，应用方才能调通本文档中接口拿到该学校相关数据。
# 接口申请地址：
发送需要申请的字段到seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com ， lindayyang@tencent.com ， ronniewan@tencent.com)，申请时需要注明应用APPKEY、应用名称、及应用使用场景
# 请求方法：
POST(application/json)
# 请求地址：
https://uni.weixiao.qq.com/open/cgi-bin/user/org-user-list?access_token=access_token
# 参数说明：
{
"org_id": 10045,
"fetch_child": 0,
"page": 1,
"page_size": 5000
}
| 参数 | 必填 | 说明 |
|---|---|---|
| access_token | 是 | 学校的权限凭证 |
| org_id | 是 | 组织架构id |
| fetch_child | 否 | 是否递归获取子组织架构下面的成员：1-是；0-否 |
| 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 | 该学校没有开启应用 |