通讯录是指上级单位（教育局）的职工组织架构和成员，以及学校的教职工的组织架构和成员，但不包括学生相关的组织架构和成员。

部门管理

创建部门（department/create）

使用场景： 在教职工，退休老师，临时组，教育局下创建一个行政部门，用于学校数据同步。创建成功后会返回部门Id，用于继续创建子部门。

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/department/create?access_token=ACCESS_TOKEN

请求包体：

 {
     "name": "教务处",
  "department_type": 2,
     "parentid": 1,
     "order": 1,
     "code": "1010931_1_838386",

 }

参数说明 ：

返回结果：

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

参数说明：

修改部门（department/update）

使用场景： 更新行政部门的名字、排序和父节点，用于学校数据同步。更新父部门则是将整个部门平移到新的父部门下边。可以更新的部门类型包括教职工，退休老师，临时组，教育局员工，更新的节点与父节点需要在同一个部门类型下面。

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/department/update?access_token=ACCESS_TOKEN

请求包体：

 {
     "id": 2,
     "name": "教务处",
     "parentid": 1,
     "order": 1,
     "code": "1010931_1_838386",
 }

参数说明 ：

返回结果：

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

参数说明：

删除部门（department/delete）

使用场景： 删除指定的学校行政部门，用于学校数据同步。可以删除的部门类型包括教职工，退休老师，临时组，教育局员工。

是否需额外授权: 是

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/department/delete?access_token=ACCESS_TOKEN&id=ID

参数说明 ：

返回结果：

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

参数说明：

获取部门列表（department/list）

使用场景： 获取学校行政部门列表，用于学校授权后的组织架构数据初始化，需缓存起来使用。

是否需额外授权: 否

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/department/list?access_token=ACCESS_TOKEN&id=ID

参数说明 ：

获取老师组织架构根节点示例： https://test-oapi.epaas.qq.com/department/list?access_token=ACCESS_TOKEN&next_level_only=1&need_role_node=true

返回结果：（下面就是获取教师组织架构根节点的返回示例，后续学生相关部门节点，可以逐层挂到“教师”节点下面）

{
   "errcode": 0,
   "errmsg": "ok",
   "department": [
       {
           "id": 222,
           "name": "xx学校",
           "parentid": 1,
           "level":1,
           "order": 0,
           "code":""
       },
       {
           "id": 223,
           "name": "教师",
           "parentid": 222,
           "level":2,
           "order":2,
           "code": ""
       }
   ]
}

参数说明：

成员管理

特别说明 成员管理接口默认只对教职工（含教育局员工）有效，若要对学校退休员工或学校临时成员进行管理，必须传入department_type字段

创建教职工（user/create）

使用场景： 创建一个教职工,临时成员，退休老师或教育局员工，用于学校数据同步。

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/create?access_token=ACCESS_TOKEN

请求包体：

 {
     "name": "张三",
     "mobile": "13800000000",
     "gender": "1",
     "user_number": "teacher001",
     "department_infos":[
         {"department_id":3032773,"title_id":25342},  
         {"department_id":3032772,"title_id":25342}
     ],
    "department_type":2,
    "basic_profile": "{\"user_number\": \"test116\",\"join_date\": \"2010-01-02\"}",
    "extend_profile": " {\"FieldA\": 111,\"FieldB\": 222,\"FieldE\": \"aaa\"} "
 }

参数说明 ：

返回结果：

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

参数说明：

更新教职工资料（user/update_info）

使用场景： 更新教职工资料

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/update_info?access_token=ACCESS_TOKEN

请求包体：

{
    "userid": "3724396827",
    "basic_profile": "{\"position\":\"\",\"teach_section\":null,\"training_info\":null,\"user_number\":\"test116\"}",
    "extend_profile": "{\"FieldA\":111,\"FieldB\":222,\"FieldE\":\"aaa\",\"_id\":\"3724396827\"}"
}

请求说明：

basic_profile和extend_profile，不能同时为空

参数说明：

返回结果：

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

参数说明：

教职工调部门（/user/move_department）

使用场景： 教职工调部门

是否需额外授权: 否

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/move_department?access_token=ACCESS_TOKEN

请求包体：

{
    "userids":["3724804326","3758412570"],
    "department_ids":[5670337,5671220],
    "department_type":2
}

参数说明：

返回结果：

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

参数说明：

删除教职工（user/delete）

使用场景： 删除指定教职工,临时成员，退休老师或教育局员工，用于学校数据同步。

是否需额外授权: 是

请求方式： GET（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/delete?access_token=ACCESS_TOKEN&userid=ID

参数说明 ：

返回结果：

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

参数说明：

退休教职工（user/retire）

使用场景： 退休教职工，退休操作是不可逆的。

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/retire?access_token=ACCESS_TOKEN

请求包体：

 {
     "userids": ["30046307", "30046308"],
      "reason": "停职"
 }

参数说明 ：

返回结果：

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

参数说明：

教职工变动（user/move）

使用场景： 教职工离岗，停职，变动等。

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/move?access_token=ACCESS_TOKEN

请求包体：

 {
     "userids":["3724361204","3724348975"],
     "reason":"测试学校退休老师",
    "move_type":2
}

参数说明 ：

返回结果：

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

参数说明：

教职工回迁（user/move_back）

使用场景： 教职工迁回(变动后迁回)。

是否需额外授权: 是

请求方式： POST（HTTPS）

请求地址： https://test-oapi.epaas.qq.com/user/move_back?access_token=ACCESS_TOKEN

请求包体：

 {
     "userid":"3724361204",
     "department_ids":[5383525]
}

参数说明 ：

返回结果：

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

参数说明：