Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
历史文档（不推荐）
  • 历史文档（不推荐）
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API（DingTalk OpenAPI）
  • 生态伙伴API
HTTP回调审批待办通讯录管理钉钉红包身份验证（免登）花名册行业连接日程
HTTP回调审批待办通讯录管理钉钉红包身份验证（免登）花名册行业连接日程
  1. 部门管理1.0(不推荐)
  • 用户管理1.0(不推荐)
    • 创建用户
      POST
    • 更新用户信息
      POST
    • 删除用户
      GET
    • 根据userid获取用户详情
      GET
    • 获取部门用户基础信息
      GET
    • 获取部门用户userid列表
      GET
    • 获取部门用户详情
      GET
    • 获取员工人数
      GET
    • 获取未登录钉钉的员工列表
      POST
    • 根据手机号获取userid
      GET
    • 根据unionid获取userid
      GET
    • 获取管理员列表
      GET
  • 部门管理1.0(不推荐)
    • 创建部门
      POST
    • 删除部门
      GET
    • 更新部门
      POST
    • 获取部门详情
      GET
    • 获取部门列表
      GET
    • 获取子部门ID列表
      GET
    • 获取指定部门的所有父部门列表
      GET
    • 获取指定用户的所有父部门列表
      GET
  1. 部门管理1.0(不推荐)

创建部门

POST
http://127.0.0.1/department/create
历史文档（不推荐）/通讯录管理/部门管理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
name
string 
必需
部门名称。长度限制为1~64个字符，不允许包含字符"-"","以及","。
parentid
string 
必需
父部门ID，根部门ID为1。
parentBalanceFirst
boolean 
可选
是否优先使用父部门的预算。
shareBalance
boolean 
可选
是否共享预算：true：是false：否
autoApproveApply
boolean 
可选
是否默认同意加入该部门的申请：true：表示加入该部门的申请将默认同意false：表示加入该部门的申请需要有权限的管理员同意
outerPermitUsers
string 
可选
outerDept为true时，可以配置额外可见人，值为userid组成的的字符串，使用“|”符号进行分隔，总数不能超过200。
outerPermitDepts
string 
可选
outerDept为true时，可以配置额外可见部门，值为部门id组成的的字符串，使用“|”符号进行分隔，总数不能超过200。
outerDept
boolean 
可选
是否限制本部门成员查看通讯录：true：开启限制，开启后本部门成员只能看到限定范围内的通讯录false：不限制
deptHiding
boolean 
可选
是否隐藏部门：true：表示隐藏false：表示显示
createDeptGroup
boolean 
可选
是否创建一个关联此部门的企业群，默认为false。
order
string 
可选
在父部门中的次序值。order值小的排序靠前。
sourceIdentifier
string 
可选
部门标识字段，开发者可用该字段来唯一标识一个部门，并与钉钉外部通讯录里的部门做映射。
deptPermits
string 
可选
可以查看指定隐藏部门的其他部门列表，如果部门隐藏，则此值生效，取值为其他的部门ID组成的的字符串，使用"|"符号进行分隔。总数不能超过200。
userPermits
string 
可选
可以查看指定隐藏部门的其他人员列表，如果部门隐藏，则此值生效，取值为其他的人员userid组成的的字符串，使用"|"符号进行分隔。总数不能超过200。
outerDeptOnlySelf
boolean 
可选
是否只能看到所在部门及下级部门通讯录：true：表示只能看到所在部门及下级部门通讯录false：不能查看所在部门及下级部门通讯录outerDept为true时，可以配置该字段。
ext
string 
可选
部门自定义字段，格式为文本类型的Json格式。
示例
{
  "name": "管理3部",
  "parentid": "1",
  "outerDept": "true",
  "outerPermitUsers": "manager4220|user123",
  "ext": "{\"职能\":\"总裁办\"}"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/department/create?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "管理3部",
    "parentid": "1",
    "outerDept": "true",
    "outerPermitUsers": "manager4220|user123",
    "ext": "{\"职能\":\"总裁办\"}"
}'

返回响应

🟢200成功
application/json
Body
errcode
number 
返回码。
可选
errmsg
string 
返回码描述。
可选
id
number 
部门ID。
可选
示例
{
  "errcode": 0,
  "errmsg": "string",
  "id": 0
}
上一页
获取管理员列表
下一页
删除部门
Built with