创建部门
使用场景： 用于创建一个学校普通教职工部门，学校退休教职工部门，学校临时组部门，行政单位员工部门；
创建成功后会返回部门Id，用于继续创建子部门。
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 需要 | 申请方式：联系项目接口人申请 |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/department/create
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| name | string | 是 | 部门名字 |
| parentid | uint32 | 是 | 父部门的Id，32位整数，根部门为1 |
| order | uint32 | 否 | 在父部门中的次序值，32位整数，越小排序越前 |
| code | string | 否 | 部门代码，机构内唯一 |
| department_type | uint32 | 否 | 要创建的部门类型，创建普通成员部门时无需指定该参数 2：普通教职工，学校默认值，即机构类型为“学校”时，不填该参数时的效果 5：退休教职工 6：临时组 9：行政单位员工，行政单位默认值，即机构类型为“行政单位”时，不填该参数时的效果 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
| id | uint32 | 创建的部门id |
创建成功后，将返回创建成功的部门Id，若后续有该部门的相关操作，需要缓存该部门Id
请求示例：
POST https://test-oapi.epaas.qq.com/department/create?access_token=ACCESS_TOKEN
请求包体：
{
"name": "教务处",
"parentid": 1,
"order": 1,
"code": "1010931_1_838386"
}
返回示例：
{
"errcode": 0,
"errmsg": "ok",
"id": 2
}
更新部门
使用场景： 用于更新部门的相关信息，包括名字，父节点等；
可以更新的部门类型包括普通教职工，退休教职工，临时组，行政单位员工；
更新父部门则是将整个部门平移到新的父部门下边，更新的节点与父节点需要在同一个部门类型下面。
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 需要 | 申请方式：联系项目接口人申请 |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/department/update
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| id | uint32 | 是 | 要修改的部门Id |
| name | string | 是 | 部门名字 |
| parentid | uint32 | 是 | 父部门的Id，32位整数 |
| order | uint32 | 是 | 在父部门中的次序值，32位整数，越小排序越前 |
| code | string | 否 | 部门唯一Code |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
请求示例：
POST 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"
}
删除部门
使用场景： 删除指定的部门
删除后的部门将无法恢复，操作需谨慎
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 需要 | 申请方式：联系项目接口人申请 |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： GET（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/department/delete
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
| id | uint32 | 是 | 部门ID 不能删除根部门，各种角色根部门 不能删除含有子部门部门，需要从下往上删除 不能删除含有成员的部门，需要先删除成员，再删除部门 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
请求示例：
GET https://test-oapi.epaas.qq.com/department/delete?access_token=ACCESS_TOKEN&id=101
请求包体：
{
"errcode": 0,
"errmsg": "ok"
}
批量创建职务
使用场景： 用户创建学校或教育局的职务
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 需要 | 申请方式：联系项目接口人申请 |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/corp/title/batch_create
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| data_list | object数组 | 是 | 职务列表数据 |
| data_list.name | string | 是 | 职务名称 (限制20个字符以内) |
| data_list.order | uint32 | 否 | 次序值, 0:(当前机构的职务最大order+1) order值越小排序越前 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
| result_list | object数组 | 结果列表 |
| result_list.errmsg | string | 返回结果 "ok":创建成功 其他:创建失败的错误信息 |
| result_list.index | uint32 | 索引值, 入参的data_list中的下标值 |
| result_list.id | uint32 | 0:失败 其他:新职务的id |
请求示例：
POST https://test-oapi.epaas.qq.com/corp/title/batch_create?access_token=ACCESS_TOKEN
请求包体：
{
"data_list": [
{
"name": "校长",
"order": 1
},
{
"name": "测试职务1",
"order": 11
}
]
}
返回示例：
{
"errmsg": "ok",
"errcode": 0,
"result_list": [
{
"errmsg": "职位:校长 已存在",
"index": 0,
"id": 0
},
{
"errmsg": "ok",
"index": 1,
"id": 1725105
}
]
}
批量修改职务
使用场景： 用户修改学校或教育局的职务
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 需要 | 申请方式：联系项目接口人申请 |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/corp/title/batch_update
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| data_list | object数组 | 是 | 职务列表数据 |
| data_list.id | uint32 | 是 | 职务id |
| data_list.name | string | 是 | 职务名称 (限制20个字符以内) |
| data_list.order | uint32 | 否 | 次序值, 0:不修改order值 越小排序越前 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
| result_list | object数组 | 结果列表 |
| result_list.errmsg | string | 返回结果 "ok":修改成功 其他:修改失败的错误信息 |
| result_list.id | uint32 | 职务id |
请求示例：
POST https://test-oapi.epaas.qq.com/corp/title/batch_update?access_token=ACCESS_TOKEN
请求包体：
{
"data_list": [
{
"id": 74130,
"name": "校长",
"order": 1
},
{
"id":1725105,
"name": "测试职务1",
"order": 11
}
]
}
返回示例：
{
"errmsg": "ok",
"errcode": 0,
"result_list": [
{
"errmsg": "职位信息不存在",
"index": 0,
"id": 74130
},
{
"errmsg": "ok",
"index": 0,
"id": 1725105
}
]
}
批量删除职务
使用场景： 用户删除学校或教育局的职务
权限说明
| 权限项 | 说明 | 备注 |
|---|---|---|
| 应用是否需要申请白名单 | 需要 | 申请方式：联系项目接口人申请 |
| 用户凭证 | 未支持 | |
| 机构凭证 | 支持 | 获取不到用户凭证的后台管理场景使用 |
请求方式： POST（HTTPS）
请求地址： https://test-oapi.epaas.qq.com/corp/title/batch_delete
Query参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 |
Body参数：
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| ids | int32数组 | 是 | 职务id列表 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 对返回码的文本描述内容 |
| result_list | object数组 | 返回结果 |
| result_list.errmsg | string | 返回结果 "ok":删除成功 其他:删除失败的错误信息 |
| result_list.id | uint32 | 职务id |
请求示例：
POST https://test-oapi.epaas.qq.com/corp/title/batch_delete?access_token=ACCESS_TOKEN
请求包体：
{
"ids": [1725105,1725106]
}
返回示例：
{
"errmsg": "ok",
"errcode": 0,
"result_list": [
{
"errmsg": "ok",
"id": 1725105
},
{
"errmsg": "职位信息不存在",
"id": 1725106
}
]
}