文档首页/ 需求管理 CodeArts Req/ API参考/ API/ OpenAPI管理/ 根据工时id删除工时
更新时间：2025-08-05 GMT+08:00
在线调试
CLI示例
查看PDF
分享

根据工时id删除工时

功能介绍

根据工时id删除工时

调用方法

请参见如何调用API。

URI

DELETE /v1/projects/{project_id}/work-items/{issue_id}/work-hour/{workhour_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。

约束限制：

正则表达式，^[A-Za-z0-9]{32}$。

取值范围：

不涉及。

默认取值：

不涉及。

issue_id

是

String

参数解释：工作项唯一Id。可以通过查询工作项列表或者查询树状工作接口获取，响应消息体中的id字段的值就是工作项ID。

约束限制：正则表达式，^([0-9]{18,19})$

默认取值：不涉及

workhour_id

是

String

工时id

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

status

String

状态

message

String

消息

result

WorkHourTotalVO object

工时信息及工时总数
表3 WorkHourTotalVO

参数

参数类型

描述

data

Array of WorkHourVO objects

工时信息列表

work_hours_total

String

实际工时总数
表4 WorkHourVO

参数

参数类型

描述

id

String

工时id

title

String

工时名称

operation_id

String

操作ID

description

String

描述

workitem_id

String

工作项id

work_date

String

工时日期

created_by

UserEntity object

创建人信息

modified_by

UserEntity object

修改人信息

work_hour_category

String

工时类型唯一标识取值为value，页面展示取值为display_value

work_hours

String

花费工时(人天)
表5 UserEntity

参数

参数类型

描述

id

String

参数解释：

用户id，可通过获取当前用户信息接口获取，响应消息体中的id字段的值就是用户id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

String

参数解释：

用户名称。

约束限制：

最小长度：2，最大长度：64。

取值范围：

不涉及。

默认取值：

不涉及。

nick_name

String

参数解释：

用户昵称。

约束限制：

最小长度：2，最大长度：30。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

根据工时id删除工时

{url}/v1/projects/dbf92424384e46dd9829492abe533829/work-items/1038401818296492033/work-hour/1038556057215868930

响应示例

状态码：200

工时信息以及工时总和信息返回

{
  "status" : "success",
  "message" : null,
  "result" : {
    "data" : [ {
      "id" : "1038556057215868930",
      "modified_by" : {
        "id" : "a360371833bf4c558f796fd707b44daf",
        "name" : "devcloud_devcloud_s00404480_01",
        "nick_name" : "t"
      }
    } ],
    "work_hours_total" : 0
  }
}

状态码

状态码

描述

200

工时信息以及工时总和信息返回

错误码

请参见错误码。

父主题： OpenAPI管理

相关文档