获取机构信息

使用场景： 获取机构的信息，可用于登录页的信息展示

• 支持获取机构自身的信息
• 支持获取下级和下下级等有管理权限的机构信息

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/corp/info

Query参数:

Body参数：

请求示例：

POST https://oapi.epaas.qq.com/corp/info?access_token=ACCESS_TOKEN

请求包体：

{
  "corpid": 1122331,
  "extend_fields": ["FieldA"]
}

返回参数：

备注：返回的source（开源来源）和app_template（应用模版）为旧版待废弃字段，新应用忽略即可

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "name": "name",
    "logo": "logo",
    "type": "ORG", 
    "country": "country",
    "province": "province",
    "city": "city",
    "area": "area",
    "edu_type": 123, 
    "section_list": [
        1,
        2
    ], 
    "code": "code", 
    "level": 1, 
    "province_code": 123, 
    "city_code": 123, 
    "area_code": 123,
    "source": 3,
    "app_template": 5,
    "qywx_corpid": "wwe6e3b576eebe2584",
    "extend_profile": "{\"FieldA\": 01}",
    "tenant_id": "1",
    "province_id": 10,
    "city_id": 10,
    "area_id": 10
}

机构管理员相关

获取机构管理员列表

使用场景： 获取学校或行政单位的管理员列表，用于判断操作权限。

权限说明

请求方式： GET(HTTPS）

请求地址： https://oapi.epaas.qq.com/corp/admin/list

Query参数:

Body参数：

返回参数：

请求示例：

GET https://oapi.epaas.qq.com/corp/admin/list?access_token=ACCESS_TOKEN&hide_creator=true

请求包体：

返回包体：

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "data_list":[
        {
            "userid": "123",
            "name": "小王",
            "role_id" : 12,
            "department" : [1,2,3],
            "admin_type": ["管理员","高级管理员"]        
        }
    ]
}

获取机构职位列表

使用场景： 获取学校下的职位列表，用于教师的职位选择或展示。

权限说明

请求方式： GET（HTTPS）

请求地址： https://oapi.epaas.qq.com/corp/title/list

Query参数:

返回参数：

请求示例：

GET https://oapi.epaas.qq.com/corp/title/list?access_token=ACCESS_TOKEN

请求包体：

返回包体：

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 2,
    "data_list":[
        {
            "id": 123,            
            "name": "校长",
            "order": 6,
            "editable": 1          
        },
        {
            "id": 123,            
            "name": "教导主任",
            "order": 7,
            "editable": 1         
        }
    ]
}

更新学校老师学生首次登录是否需要修改密码

使用场景： 更新学校老师学生首次登录是否需要修改密码

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/corp/school/update_password_first

Query参数:

Body参数：

返回参数：

请求示例：

POST https://oapi.epaas.qq.com/corp/school/update_password_first?access_token=ACCESS_TOKEN

请求包体：

{
  "teacher_update_password_first": 0,
  "student_update_password_first": 0
}

返回包体:

{
    "errcode": 0,
    "errmsg": "ok"
}

查询是否为机构管理员

使用场景： 判断用户是否具有指定的管理员角色

• 支持教育局和学校

权限说明

请求方式： POST（HTTPS）

请求地址： https://oapi.epaas.qq.com/corp/is_org_admin

Query参数:

Body参数：

返回参数：

请求示例：

POST https://oapi.epaas.qq.com/corp/is_org_admin?access_token=ACCESS_TOKEN

请求包体：

{
  "userid":"user_123",
  "admin_type_list": [1,3,9]
}

返回示例：

{
    "errcode": 0,
    "errmsg": "ok",
    "is_admin": true
}

添加机构管理员

请求地址: /https://oapi.epaas.qq.com/auth/user/add_dpt_admin?access_token=USER_ACCESS_TOKEN

接口说明：支持教育局和学校,支持给下属教育局和学校添加管理员

权限说明

请求方法: POST

请求参数:

返回结果：

{
  "errcode": 0,
  "errmsg": "ok"
}

参数说明:

删除机构或部门管理员

请求地址: /https://oapi.epaas.qq.com/auth/user/delete_dpt_admin?access_token=USER_ACCESS_TOKEN

接口说明：支持教育局和学校,支持给下属教育局和学校删除管理员

权限说明

请求方法: POST

请求参数:

返回结果：

{
  "errcode": 0,
  "errmsg": "ok"
}

参数说明:

查询管理员详情

请求地址: /https://oapi.epaas.qq.com/auth/user/dpt_admin_info?access_token=ACCESS_TOKEN

接口说明：支持教育局和学校,查询超级管理员和部门管理员详情

权限说明

请求方法: GET

请求示例： https://oapi.epaas.qq.com/auth/user/dpt_admin_info?access_token=ACCESS_TOKEN&userid=100001

请求参数:

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "department_ids": [
        5165437,
        5366682
    ],
    "name": "测试",
    "userid": "10001",
    "admin_types": [
        4
    ],
    "range_type": 3
}

参数说明:

查询部门管理员列表

请求地址: /https://oapi.epaas.qq.com/auth/user/dpt_admin_users?access_token=USER_ACCESS_TOKEN

接口说明：支持教育局和学校,查询部门管理员列表

权限说明

请求方法: POST

请求示例：

{
  "app_role_ids":["4"],
  "page_index":1,
  "page_size":30,
  "department_ids":[]
}

请求参数: 注意:如果入参department_ids不为空,那么会查询所有匹配到的部门管理员,这个时候不会做分页处理,也就是会忽略入参page_index和page_size

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "data_list": [
        {
            "userid": "3729824015",
            "name": "祝福",
            "mobile": "189****1234",
            "user_number": "1111122222",
            "app_role_id": "4",
            "app_role_name": "部门管理员",
            "department_ids":[1001,1002]
        },
        {
            "userid": "3729824011",
            "name": "李金全",
            "mobile": "182****1234",
            "user_number": "111222333",
            "app_role_id": "4",
            "app_role_name": "部门管理员",
            "department_ids":[1001]
        }
    ],
    "total": 2
}

参数说明:

添加或修改部门管理员

请求地址: /https://oapi.epaas.qq.com/auth/user/edit_dpt_admin_info?access_token=USER_ACCESS_TOKEN

接口说明：支持教育局和学校,添加或修改部门管理员

权限说明

请求方法: POST

请求示例：

{
  "userids":["100001","100002],
  "app_role_id":"4",
  "department_ids":[1234]
}

请求参数:

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
}

参数说明:

根据角色获取用户列表

使用场景： 根据角色id获取学校或行政单位的用户列表, 可查询各类管理员

权限说明

请求方式： GET(HTTPS）

请求地址： https://oapi.epaas.qq.com/auth/role/users

Query参数:

Body参数：

返回参数：

请求示例：

GET https://oapi.epaas.qq.com/auth/role/users?access_token=ACCESS_TOKEN&app_role_id=3&keyword=&page_index=1&page_size=30

请求包体：

返回包体：

{
    "errmsg": "ok",
    "errcode": 0,
    "total": 1,
    "user_list": [
        {
            "userid": "3730526139",
            "name": "陶敏一九九的账号",
            "mobile": "199****5200",
            "department_id": 0,
            "user_number": "12312312412312",
            "corpid": "1009697"
        }
    ]
}