Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 组织
  • 花名册
    • 获取花名册字段组详情
      POST
    • 获取员工花名册字段信息
      POST
    • 更新员工花名册信息
      POST
    • 获取花名册元数据
      POST
  • 组织
    • 获取部门的扩展字段定义
      POST
    • 获取部门扩展信息
      POST
    • 更新部门扩展信息
      POST
  • 获取在职员工列表
    POST
  • 获取待入职员工列表
    POST
  • 获取员工离职信息
    POST
  • 获取离职员工列表
    POST
  • 添加企业待入职员工
    POST
  1. 组织

获取部门扩展信息

POST
http://127.0.0.1/topapi/smartwork/hrm/organization/dept/get
服务端API/智能人事/组织
最后修改时间:2022-08-30 09:19:22
责任人:未设置

说明#

调用本接口获取部门扩展信息。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用否——
第三方个人应用否——

请求参数

Query 参数
access_token
string 
必需
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
field_code_list
array[string]
字段列表。
可选
示例
{
  "field_code_list": [
    "cc_userids"
  ]
}

示例代码

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/topapi/smartwork/hrm/organization/dept/get?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "field_code_list": [
        "cc_userids"
    ]
}'

返回响应

🟢200成功
application/json
Body
result
array [object {3}] 
结果集。
可选
ext_options
array [object {2}] 
扩展字段结果集。
可选
field_name
string 
字段名称。
可选
field_code
string 
字段code。
可选
errmsg
string 
返回码描述。
可选
errcode
number 
返回码。
可选
success
boolean 
成功标记。
可选
示例
{
  "result": [
    {
      "ext_options": [
        {
          "text": "string",
          "key": "string"
        }
      ],
      "field_name": "string",
      "field_code": "string"
    }
  ],
  "errmsg": "string",
  "errcode": 0,
  "success": true
}
上一页
获取部门的扩展字段定义
下一页
更新部门扩展信息
Built with