获取部门列表

GET

/cgi-bin/school/department/list

服务端API第三方应用开发企业内部开发

权限说明：学校需要使用“家校沟通”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。第三方应用需拥有「家校沟通」使用权限。

文档ID: 18840
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92299
https://open.work.weixin.qq.com/api/doc/90000/90135/92343

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/school/department/list?access_token=&id={{id}}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "departments": [
    {
      "name": "一年级",
      "parentid": 1,
      "id": 2,
      "type": 2,
      "register_year": 2018,
      "standard_grade": 1,
      "order": 1,
      "department_admins": [
        {
          "userid": "zhangsan",
          "type": 1
        },
        {
          "userid": "lisi",
          "type": 2
        }
      ],
      "is_graduated": 0
    },
    {
      "name": "一年级一班",
      "parentid": 1,
      "id": 3,
      "type": 1,
      "department_admins": [
        {
          "userid": "zhangsan",
          "type": 3,
          "subject": "语文"
        },
        {
          "userid": "lisi",
          "type": 4,
          "subject": "数学"
        }
      ],
      "open_group_chat": 1,
      "group_chat_id": "group_chat_id"
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

必需

部门id。（注：不能删除根部门；不能删除含有子部门、成员的部门）

示例值:

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

departments

array [object {7}]

部门列表数据

可选

open_group_chat

integer <int32>

可选

是否开启班级群，1表示开启，0表示关闭。仅部门类型为班级时才返回该字段

name

string

部门名称

可选

group_chat_id

string

可选

班级群id。仅部门类型为班级时且open_group_chat为1时才返回该字段

department_admins

array [object {3}]

可选

integer <int32>

可选

部门id,根部门固定为1

type

integer <int32>

可选

部门类型，32位整型，1表示班级，2表示年级，3表示学段，4表示校区，5表示学校（根部门）

parentid

integer <int32>

可选

父亲部门id,根部门该项为0

修改于 2022-12-02 03:10:35

删除部门

修改自动升年级的配置