飞书项目(Meegle)API 文档社区版
首页飞书项目插件管理Node.js SDK
首页飞书项目插件管理Node.js SDK
  1. 流程与节点
  • 插件相关
    • 获取plugin_token
      POST
    • 获取code
      POST
    • 获取user_plugin_token
      POST
    • 刷新token
      POST
  • 附件
    • 添加附件
      POST
    • 文件上传
      POST
    • 下载附件
      POST
    • 删除附件
      POST
  • 空间
    • 获取空间列表
      POST
    • 获取空间详情
      POST
    • 获取空间下业务线详情
      GET
    • 获取空间下工作项类型
      GET
    • 获取空间下团队成员
      GET
  • 用户
    • 获取用户详情
      POST
    • 搜索租户内的用户列表
      POST
    • 创建自定义用户组
      POST
    • 更新用户组成员
      PATCH
    • 查询用户组成员
      POST
  • 空间关联
    • 获取空间关联规则列表
      POST
    • 获取空间关联下的关联工作项实例列表
      POST
    • 绑定空间关联的关联工作项实例
      POST
    • 解绑空间关联的关联工作项实例
      DELETE
  • 工作项实例搜索
    • 获取指定的工作项列表(单空间)
    • 获取指定的工作项列表(跨空间)
    • 获取指定的工作项列表(单空间-复杂传参)
    • 获取指定的工作项列表(全局搜索)
    • 获取指定的关联工作项列表(单空间)
  • 工作项实例读写
    • 评审管理
      • 批量查询评审意见、评审结论
      • 修改评审结论和评审意见
      • 评审结论标签值查询
    • 工作项工时
      • 获取工作项的工时记录列表
      • 创建实际工时
      • 更新实际工时
      • 删除实际工时
    • 创建工作项资源库
    • 交付物信息批量查询(WBS)
    • 工作项冻结/解冻
    • 获取工作项详情
    • 获取创建工作项元数据
    • 创建工作项
    • 更新工作项
    • 批量更新工作项字段值
    • 获取批量更新处理进度
    • 删除工作项
    • 终止/恢复工作项
    • 获取工作项操作记录
  • 工作项配置
    • 字段配置
      • 获取字段信息
      • 创建自定义字段
      • 更新自定义字段
    • 关系配置
      • 获取工作项关系列表
      • 新增工作项关系
      • 更新工作项关系
      • 删除工作项关系
    • 获取工作项基础信息配置
    • 更新工作项基础信息配置
  • 流程与节点
    • 获取指定节点/状态流转所需必填信息
      POST
    • 获取工作流详情
      POST
    • 获取工作流详情(WBS)
      GET
    • 更新节点/排期
      PUT
    • 节点完成/回滚
      POST
    • 状态流转
      POST
  • 流程配置
    • 获取工作项下的流程模板列表
    • 获取流程模板配置详情
    • 新增流程模板
    • 更新流程模板
    • 删除流程模板
  • 角色与人员配置
    • 获取流程角色配置详情
  • 子任务
    • 获取指定的子任务列表(跨空间)
    • 获取子任务详情
    • 创建子任务
    • 更新子任务
    • 子任务完成/回滚
    • 删除子任务
  • 视图
    • 获取视图列表及配置信息
    • 获取视图下工作项列表
    • 获取视图下工作项列表(全景视图)
    • 创建固定视图
    • 更新固定视图
    • 创建条件视图
    • 更新条件视图
    • 删除视图
  • 评论
    • 添加评论
    • 查询评论
    • 更新评论
    • 删除评论
  • 群组
    • 拉机器人入群
  • 度量
    • 获取度量图表明细数据
  1. 流程与节点

获取工作流详情(WBS)

GET
/open_api/{project_key}/work_item/{work_item_type_key}/{work_item_id}/wbs_view
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/open_api//work_item///wbs_view' \
--header 'X-PLUGIN-TOKEN: {{plugin_token}}' \
--header 'X-USER-KEY: {{user_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "expand": {
        "need_workflow": "string",
        "need_multi_text": "string",
        "relation_fields_detail": "string",
        "need_union_deliverable": "string",
        "need_wbs_relation_chain_entity": "string",
        "need_wbs_relation_chain_path": "string"
    }
}'
响应示例响应示例
{
    "err_code": 0,
    "data": {
        "template_key": "123123123", //使用的模板key 
        "related_sub_work_items": [ //关联子工作项 
            {
                "node_uuid": "1", //节点uuid 
                "work_item_id": 5566778, //工作项id 
                "type": "node", //节点类型(节点node、子任务sub_task、子工作项sub_workitem) 
                "name": "开始", //节点名称 
                "wbs_status_map": { //wbs状态映射信息 
                    "status_key": "not_started",
                    "status_name": "未开始"
                },
                "sub_work_item": [
                    {
                        "deliverable": [ //交付物(字段类型,按复合字段结构返回) 
                            {
                                "field_key": "field_b46006",
                                "field_value": [
                                    [
                                        {
                                            "field_key": "field_cf394a",
                                            "field_value": "2323"
                                        },
                                        {
                                            "field_key": "field_db2cd2",
                                            "field_value": "4545"
                                        },
                                        {
                                            "field_key": "field_ec3f89",
                                            "field_value": "rd"
                                        }
                                    ]
                                ]
                            }
                        ],
                        "name": "任务1",
                        "node_uuid": "3",
                        "work_item_id": 5566712,
                        "type": "sub_task",
                        "role_owners": [ //角色负责人
                            {
                                "role": "DA",
                                "name": "DA",
                                "owners": [
                                    "70439708518xxxxxx06",
                                    "70970434698xxxxxx04"
                                ]
                            },
                            {
                                "role": "PM",
                                "name": "PM"
                            }
                        ],
                        "wbs_status_map": {
                            "status_key": "not_started",
                            "status_name": "未开始"
                        },
                        "sub_work_item": []
                    }
                ],
                "union_deliverable": {
                    "field_deliverables": [
                        {
                            "field_info": {
                                "field_key": "name",
                                "field_value": "名称",
                                "field_value_type": "name"
                            },
                            "placeholder": "占位符",
                            "remark": "标记",
                            "status": 1
                        }
                    ],
                    "instance_deliverables": [
                        {
                            "name": "交付物工作项名称",
                            "work_item_id": 67958762134534,
                            "associated_deliverables_template": 7892347234343,
                            "template_resources": false,
                            "deletable": true,
                            "must_complete": false,
                            "state_key": "started",
                            "state_name": "开始",
                            "owners": [
                                "7325343738828423187"
                            ],
                            "remark": "标记"
                        }
                    ]
                }
            }
        ],
        "relation_chain_path": {
            "wbs_relation_chain_path": [
                {
                    "project_key": "66c2fb3e0ab52f52c9296ca2",
                    "level": 1,
                    "type": "rootWorkItem",
                    "work_item_type_key": "66c32aded7baa5712eac007f",
                    "name": "默认WBSTest类型",
                    "node_name": ""
                },
                {
                    "project_key": "66c2fb3e0ab52f52c9296ca2",
                    "level": 2,
                    "type": "subWorkItem",
                    "work_item_type_key": "66c32aded7baa5712eac007f",
                    "name": "默认WBSTest类型",
                    "node_name": "测试 4"
                },
                {
                    "project_key": "66c2fb3e0ab52f52c9296ca2",
                    "level": 3,
                    "type": "subWorkItem",
                    "work_item_type_key": "6719c3142382800cfa1f4e53",
                    "name": "",
                    "node_name": "开始"
                },
                {
                    "project_key": "66c2fb3e0ab52f52c9296ca2",
                    "level": 4,
                    "type": "subWorkItem",
                    "work_item_type_key": "66c32aded7baa5712eac007f",
                    "name": "",
                    "node_name": "测试流程23"
                }
            ],
            "work_item_id": 102932427
        },
        "relation_chain_entity": {
            "wbs_relation_chain_entity": [
                {
                    "project_key": "66c2fb3e0ab52f52c9296ca2",
                    "work_item_type_key": "66c32aded7baa5712eac007f",
                    "work_item_id": 102920361,
                    "type": "rootWorkItem",
                    "work_item_name": "自测6",
                    "state_key": "",
                    "node_name": "",
                    "sub_task_id": 0,
                    "sub_task_name": "",
                    "level": 1
                },
                {
                    "project_key": "66c2fb3e0ab52f52c9296ca2",
                    "work_item_type_key": "6719c3142382800cfa1f4e53",
                    "work_item_id": 102920362,
                    "type": "subWorkItem",
                    "work_item_name": "测试 4",
                    "state_key": "",
                    "node_name": "",
                    "sub_task_id": 0,
                    "sub_task_name": "",
                    "level": 2
                }
            ],
            "work_item_id": 102932427
        }
    },
    "err_msg": ""
}

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

修改于 2025-07-11 07:00:32
上一页
获取工作流详情
下一页
更新节点/排期
Built with