获取组织历史记录列表接口

scope: org:history:list

基本信息

项目	说明
接口路径	`POST /open/api/v1/org/getOrgHistoryList`
Content-Type	`application/json`
所需权限	`org:history:list`
接口说明	获取指定组织的所有历史记录列表（时间轴），按生效时间降序排列

请求参数

请求体（Request Body）

参数名	类型	是否必填	说明	示例
`corpId`	String	是	企业ID	`"ding4c7c311a701851ac35c2f4657eb6378f"`
`orgId`	String	是	组织ID	`"org_14bfa9a7264848ea929a03151121816c"`

请求示例

{
    "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
    "orgId": "org_14bfa9a7264848ea929a03151121816c"
}

响应参数

外层结构（ApiResponse）

参数名	类型	说明
`data`	Array<Object>	组织历史记录列表，按生效时间降序排列；组织不存在时返回空数组 `[]`
`success`	Boolean	请求是否成功
`errorCode`	String	错误编码，正常为 `null`
`errorMsg`	String	错误信息，正常为 `null`

data 数组元素结构（OrgOpenVO）

参数名	类型	说明
`corpId`	String	企业ID
`orgId`	String	组织ID
`dataMap`	Object	该条历史记录的组织属性详情，见下方 dataMap 结构

dataMap 结构

参数名	类型	说明
`id`	String	记录唯一标识
`name`	String	组织名称
`code`	String	组织编码
`type`	String	组织类型，如 `department`
`status`	String	组织状态：`enable`（启用）、`disable`（停用）
`effectDate`	String	生效日期，格式: `yyyy-MM-dd HH:mm:ss`
`invalidDate`	String	失效日期，格式: `yyyy-MM-dd HH:mm:ss`
`parentOrgId`	String	上级组织ID
`managerEmpId`	Array<String>	组织负责人员工ID列表
`order`	Number	组织排序序号
`corpId`	String	企业ID
`orgId`	String	组织ID
`delete`	String	删除标记，`"0"` 表示未删除
`disable`	Boolean	是否禁止停用按钮
`children`	Array	子节点列表
`gmtCreate`	String	创建时间，格式: `yyyy-MM-dd HH:mm:ss`
`gmtModified`	String	修改时间，格式: `yyyy-MM-dd HH:mm:ss`

注：dataMap 中还可能包含企业自定义字段，具体取决于企业配置。

响应示例

查询成功（有历史记录）

{
    "data": [
        {
            "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
            "orgId": "org_14bfa9a7264848ea929a03151121816c",
            "dataMap": {
                "effectDate": "2027-01-01 00:00:00",
                "gmtModified": "2026-02-09 16:48:25",
                "code": "",
                "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
                "managerEmpId": [],
                "type": "department",
                "gmtCreate": "2025-12-12 21:57:35",
                "invalidDate": "2099-12-31 00:00:00",
                "delete": "0",
                "orgId": "org_14bfa9a7264848ea929a03151121816c",
                "parentOrgId": "org_e5d652fd4e0f4752b6832e5c75871775",
                "children": [],
                "disable": false,
                "name": "三月导入合同公司不存在",
                "id": "69899f58e4b03ff088d62d62",
                "status": "disable",
                "order": 12088
            }
        },
        {
            "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
            "orgId": "org_14bfa9a7264848ea929a03151121816c",
            "dataMap": {
                "effectDate": "2025-12-12 00:00:00",
                "gmtModified": "2026-02-09 16:48:25",
                "code": "",
                "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",
                "managerEmpId": [],
                "type": "department",
                "gmtCreate": "2025-12-12 21:57:35",
                "invalidDate": "2027-01-01 00:00:00",
                "delete": "0",
                "orgId": "org_14bfa9a7264848ea929a03151121816c",
                "parentOrgId": "org_e5d652fd4e0f4752b6832e5c75871775",
                "children": [],
                "disable": false,
                "name": "三月导入合同公司不存在",
                "id": "693c1f4fc27987593f469002",
                "status": "enable",
                "order": 12088
            }
        }
    ],
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

查询成功（组织不存在或无历史记录）

{
    "data": [],
    "success": true,
    "errorCode": null,
    "errorMsg": null
}

参数校验失败

当必填参数为空时，框架层直接返回校验错误。

{
    "success": false,
    "errorCode": "400",
    "errorMsg": "企业ID不能为空"
}

业务处理流程

请求进入
  │
  ├── 1. 参数校验（corpId / orgId 不能为空）
  │
  ├── 2. 权限校验（需要 org:history:list 权限）
  │
  ├── 3. 查询该组织的所有历史记录
  │     └── 无记录 → 返回空数组 []
  │
  ├── 4. 按生效时间降序排列
  │
  ├── 5. 转换为 OrgOpenVO（包含 dataMap）
  │
  └── 返回结果列表

注意事项

排序规则：返回的历史记录按 effectDate 降序排列，即最新生效的记录排在最前面

组织不存在：当 orgId 对应的组织不存在时，不会报错，而是返回空数组 []

时间轴含义：每条记录代表该组织在某个时间段内的状态快照，通过 effectDate（生效日期）和 invalidDate（失效日期）界定时间范围

状态值说明：status 字段为 enable 表示启用状态，disable 表示停用状态

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200获取指定组织的历史记录列表（时间轴）-Example

application/json

Bodyapplication/json

示例

{
    "data": [
        {
            "corpId": "", //企业ID
            "orgId": "", //组织Id
            /**
             * org属性
             * 列子
             * name：测试组织
             * managerList:["1","2"]
             */
            "dataMap": {
                "key": {}
            }
        }
    ],
    "success": false, //请求是否成功标志位
    "errorCode": "", //响应编码
    "errorMsg": "" //响应具体信息
}

获取指定组织的历史记录列表（时间轴）

获取组织历史记录列表接口#

基本信息#

请求参数#

请求体（Request Body）#

请求示例#

响应参数#

外层结构（ApiResponse）#

data 数组元素结构（OrgOpenVO）#

dataMap 结构#

响应示例#

查询成功（有历史记录）#

查询成功（组织不存在或无历史记录）#

参数校验失败#

业务处理流程#

注意事项#

请求参数

请求示例代码

返回响应

获取组织历史记录列表接口

基本信息

请求参数

请求体（Request Body）

请求示例

响应参数

外层结构（ApiResponse）

data 数组元素结构（OrgOpenVO）

dataMap 结构

响应示例

查询成功（有历史记录）

查询成功（组织不存在或无历史记录）

参数校验失败

业务处理流程

注意事项