更新部门

POST

http://127.0.0.1/department/update

历史文档（不推荐）/通讯录管理/部门管理1.0(不推荐)

最后修改时间：2022-08-30 09:19:22

责任人：未设置

说明

调用本接口更新部门信息。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端API授权凭证，可通过获取企业内部应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

number

必需

部门ID，可通过调用获取部门列表接口获取。

orgDeptOwner

string

可选

企业群群主的userid。

outerPermitUsers

string

可选

outerDept为true时，可以配置额外可见人，值为userid组成的的字符串，使用“|”符号进行分隔，总数不能超过200。

outerPermitDepts

string

可选

outerDept为true时，可以配置额外可见部门，值为部门id组成的的字符串，使用“|”符号进行分隔，总数不能超过200。

outerDept

boolean

可选

是否限制本部门成员查看通讯录：true：开启限制，开启后本部门成员只能看到限定范围内的通讯录false：不限制

deptHiding

boolean

可选

是否隐藏部门：true：表示隐藏false：表示显示

deptManagerUseridList

string

可选

部门的主管列表，取值为由主管的userid组成的字符串，不同的userid使用"|"符号进行分隔。

createDeptGroup

boolean

可选

是否创建一个关联此部门的企业群，默认为false。

autoAddUser

boolean

可选

当群已经创建后，是否有新人加入部门时会自动加入该群：true：自动加入群false：不会自动加入群

autoApproveApply

boolean

可选

是否默认同意加入该部门的申请：true：表示加入该部门的申请将默认同意false：表示加入该部门的申请需要有权限的管理员同意

order

string

可选

在父部门中的次序值，order值小的排序靠前。

parentid

string

可选

父部门ID，1为根部门。

lang

string

可选

通讯录语言，默认zh_CN。

name

string

可选

部门名称。长度限制为1~64个字符，不允许包含字符"-"","以及","。

sourceIdentifier

string

可选

部门标识字段，开发者可用该字段来唯一标识一个部门，并与钉钉外部通讯录里的部门做映射。

userPermits

string

可选

可以查看指定隐藏部门的其他人员列表，如果部门隐藏，则此值生效，取值为其他的人员userid组成的的字符串，使用"|"符号进行分隔。总数不能超过200。

deptPermits

string

可选

可以查看指定隐藏部门的其他部门列表，如果部门隐藏，则此值生效，取值为其他的部门ID组成的的字符串，使用"|"符号进行分隔。总数不能超过200。

outerDeptOnlySelf

boolean

可选

是否只能看到所在部门及下级部门通讯录：true：表示只能看到所在部门及下级部门通讯录false：不能查看所在部门及下级部门通讯录outerDept为true时，可以配置该字段。

groupContainSubDept

boolean

可选

部门群是否包含子部门：true：包含false：不包含

groupContainOuterDept

boolean

可选

部门群是否包含外包部门：true：包含false：不包含

groupContainHiddenDept

boolean

可选

部门群是否包含隐藏部门：true：包含false：不包含

ext

string

可选

部门自定义字段，格式为文本类型的Json格式。

示例

{
  "sourceIdentifier": "1",
  "userPermits": "1|1",
  "userPerimits": "1",
  "orgDeptOwner": "0115074162",
  "outerDept": "true",
  "deptManagerUseridList": "0115074162|01150741646",
  "parentid": "1",
  "groupContainSubDept": "false",
  "outerPermitUsers": "1",
  "outerDeptOnlySelf": "false",
  "outerPermitDepts": "1",
  "deptPerimits": "1",
  "groupContainHiddenDept": "false",
  "createDeptGroup": "true",
  "groupContainOuterDept": "false",
  "name": "接口测试",
  "id": 420727358,
  "lang": "zh_CN",
  "autoAddUser": "true",
  "deptHiding": "true",
  "deptPermits": "1|2",
  "order": "1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/department/update?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sourceIdentifier": "1",
    "userPermits": "1|1",
    "userPerimits": "1",
    "orgDeptOwner": "0115074162",
    "outerDept": "true",
    "deptManagerUseridList": "0115074162|01150741646",
    "parentid": "1",
    "groupContainSubDept": "false",
    "outerPermitUsers": "1",
    "outerDeptOnlySelf": "false",
    "outerPermitDepts": "1",
    "deptPerimits": "1",
    "groupContainHiddenDept": "false",
    "createDeptGroup": "true",
    "groupContainOuterDept": "false",
    "name": "接口测试",
    "id": 420727358,
    "lang": "zh_CN",
    "autoAddUser": "true",
    "deptHiding": "true",
    "deptPermits": "1|2",
    "order": "1"
}'

返回响应

🟢200成功

application/json

Body

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

number

可选

示例

{
  "errcode": 0,
  "errmsg": "string",
  "id": 0
}

删除部门

获取部门详情

更新部门

说明#

权限#

请求参数

示例代码

返回响应

说明

权限