该文档已下架,并且不再维护,新文档请参考点击此处

# 获取多个组织架构的成员

只有学校对应用处于开启状态时,应用方才能调通本文档中接口拿到该学校相关数据。

# 接口申请地址:

发送需要申请的字段到zhimuli@tencent.com进行申请,申请时需要注明应用APPKEY、应用名称、及应用使用场景

# 请求方法:

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 school_code不存在
40007 学号不存在
40008 权限不足
40009 参数缺失
40010 参数错误
40018 该学校没有开启应用