获取指定的组织
生产环境
https://app91651.eapps.dingtalkcloud.com
生产环境
https://app91651.eapps.dingtalkcloud.com
POST
https://app91651.eapps.dingtalkcloud.com
接口文档：获取指定的组织
org:detailbody参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| corpId | String | 是 | 企业Id |
| orgId | String | 是 | 组织ID |
| effectDate | String | 否 | 生效日期（格式：yyyy-MM-dd，未传则使用当前日期） |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 接口是否响应成功 |
| errorCode | String | 错误码（成功时为null） |
| errorMsg | String | 错误提示原因（成功时为null） |
| data | Object | 返回结果 |
data 数据结构
| 名称 | 类型 | 描述 |
|---|---|---|
| corpId | String | 企业ID |
| orgId | String | 组织ID |
| dataMap | Object | 组织详细属性数据 |
dataMap 组织属性字段说明
一、基础信息字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| id | String | 记录唯一标识（ObjectId） |
| orgId | String | 组织ID（部门ID） |
| corpId | String | 企业ID |
| name | String | 组织名称 |
| code | String | 组织编码 |
| type | String | 组织类型 |
| order | Integer | 组织序号（用于排序） |
| status | String | 组织状态（enable-启用，disable-停用） |
| disable | Boolean | 是否停用 |
| delete | String | 删除状态（"0"-正常，其他值表示已删除） |
二、组织关系字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| parentOrgId | String | 上级组织ID |
| managerEmpId | Array of String | 组织负责人员工ID列表 |
| children | Array | 子组织列表（查询详情时为空数组） |
三、关联信息字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| costCenterId | String | 成本中心ID |
| costCenterCode | String | 成本中心编码 |
| contractCompany | String | 合同公司 |
四、日期字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| effectDate | String | 生效日期（格式：yyyy-MM-dd HH:mm:ss） |
| invalidDate | String | 失效日期（格式：yyyy-MM-dd HH:mm:ss） |
| gmtCreate | String | 创建时间（格式：yyyy-MM-dd HH:mm:ss） |
| gmtModified | String | 修改时间（格式：yyyy-MM-dd HH:mm:ss） |
五、自定义字段
| 字段名模式 | 类型 | 描述 |
|---|---|---|
| field_org_stri_xxx | String | 自定义字符串字段 |
| field_org_date_xxx | String | 自定义日期字段（格式：yyyy-MM-dd HH:mm:ss） |
| field_org_numb_xxx | Number | 自定义数字字段 |
| field_org_sele_xxx | Array of String | 自定义下拉字段（选项value数组） |
枚举值说明
type 组织类型
| value | label |
|---|---|
| department | 部门 |
| company | 公司 |
| group | 集团 |
status 组织状态
| value | label |
|---|---|
| enable | 启用 |
| disable | 停用 |
delete 删除状态
| value | label |
|---|---|
| 0 | 正常 |
| (UUID) | 已删除 |
返回示例
{
"data": {
"corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
"orgId": "1",
"dataMap": {
"effectDate": "2025-09-17 00:00:00",
"gmtModified": "2025-10-14 20:31:25",
"code": "1233434",
"corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
"managerEmpId": [],
"type": "department",
"gmtCreate": "2025-09-17 17:06:48",
"invalidDate": "2099-12-31 00:00:00",
"delete": "0",
"orgId": "1",
"children": [],
"disable": false,
"name": "静静测试1",
"field_org_date_002": "2024-07-24 00:00:00",
"id": "68ca7a28b088b4784b8c8f6c",
"field_org_sele_006": [
"selection_40b77f70367b4de0894c076712c34863"
],
"status": "enable",
"order": 0
}
},
"success": true,
"errorCode": null,
"errorMsg": null
}注意事项
1.
effectDate 参数查询在该时间点生效的组织数据，支持查询组织的历史版本2.
dataMap 中以 field_org_ 开头的字段为企业自定义字段，字段名格式为 field_org_{type}_{fieldId}3.
4.
data 返回 null5.
children 字段返回空数组，如需获取子组织请使用 getOrgChildList 接口请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-02-06 07:41:07