部门同步

一、接口URL

/department/on/official?token=xxxxxxxxxxxxx

 

二、功能

组织部门同步(*注: 07:00-23:59时段同步阀值10000次/天,超出返回错误;00:00-06:59时段不做阀值限制)

 

三、请求参数

名称 类型 是否必传 传参方式 说明
token string true RequestParam 访问的key
Operate String true RequestBody 同步动作,候选值:"new": 新建部门 "delete": 部门删除 "move": 部门移动或者改名 "update": 修改部门排序
parentNames Array true RequestBody 父部门名称,全路径字符串数组; "Operate"字段为"new","delete","update"时有效, 必填; 如: 研发部/服务器组,格式为:["研发部","服务器组"]; []是根部门。
name String true RequestBody 部门名称,"Operate"字段为"new","delete","update"时有效;必填。
orderFlag Int false RequestBody 排序值, "Operate"字段为"new","update"时有效;非必填。
oldNames Array false RequestBody 旧部门名称,字符串数组; 格式同"name"字段; "Operate"字段为"move"时有效,表示被改名或者移动的部门旧名称。
newNames Array false RequestBody 新部门名称,字符串数组; 格式同"name"字段; "Operate"字段为"move"时有效,表示被改名或者移动的部门新名称。

 

四、请求体

1.新建部门:

{    "Operate": "new",    "parentNames": ["研发部",],    "name": "服务器组"}

2.删除部门:

{    "Operate": "delete",    "parentNames": ["研发部",],    "name": "服务器组"}

3.部门改名, "研发部/服务器组" 改名为 "研发部/后台任务组":

{    "Operate": "move",    "oldNames": ["研发部","服务器组"],    "newNames": ["研发部","后台工作组"]}

4.部门移动, "研发部/服务器组" 移动到 "研发二部":

{    "Operate": "move",    "oldNames": ["研发部","服务器组"],    "parentNames": ["研发二部","服务器组"]}

 

五、返回参数

名称 类型 说明
errorCode Integer 结果码,0: 成功, 非0:失败(具体描述见错误码表
errorMessage String 错误描述
requestId String 请求唯一ID。

 

六、返回体

{    "errorCode": 0,    "errorMessage": "success",    "requestId": "openapi-ums-165-17e9061a-adc5-4392-b160-0305fb65a0f5"}

 

七、备注

1.删除部门时, 此部门必须没有用户,也没有子部门。
2.部门改名、移动时,新部门的名称的父部门必须存在。