修改工作项工时操作记录
功能介绍
修改工作项工时操作记录。
调用方法
请参见如何调用API。
URI
PUT /v3/projects/{project_uuid}/issues/{issue_id}/work-hours/{work_hours_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_uuid |
是 |
String |
参数解释: 项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目的UUID。 约束限制: 32位的数字和字母组成的字符串。 取值范围: 不涉及。 默认取值: 不涉及。 |
issue_id |
是 |
Integer |
参数解释: 工作项id,可通过高级查询工作项接口获取,响应消息体中的id字段的值就是工作项id。 约束限制: 长度在1位到10位之间的纯数字。 取值范围: 最小长度:1,最大长度:10。 默认取值: 不涉及。 |
work_hours_id |
是 |
String |
参数解释: 工时id。用户通过获取工作项工时记录接口获取,响应消息体中的id字段的值就是工时id。 约束限制: 32个字母(包括大写和小写)和数字组成的字符串。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
summary |
否 |
String |
参数解释: 工作内容。 约束限制: 长度为 0 到 128 个字符的任意字符串。 取值范围: 不涉及。 默认取值: 不涉及。 |
work_hours |
否 |
String |
参数解释: 工时总数(若工时日期范围包含多天,单日工时将设为“工时总数/天数”)。 约束限制: 不涉及。 取值范围: 最小值:0.0,最大值:100000000。 默认取值: 不涉及。 |
work_hour_type |
否 |
Integer |
参数解释: 工时类型,可通过查询项目下的工时类型接口获取,响应消息体中的id字段的值就是工时类型id。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
result |
GetWorkingHoursResponse object |
参数解释: 返回结果。 |
status |
String |
参数解释: 返回状态。 取值范围: success:返回成功 error :返回失败 |
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
参数解释: 工作项工时操作记录总数。 取值范围: 不涉及。 |
data |
Array of IssueWorkHours objects |
参数解释: 工作项工时操作记录列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释: 主键。 取值范围: 32位UUID字符串。 |
issueId |
Integer |
参数解释: 工作项ID。 取值范围: 不涉及。 |
userId |
String |
参数解释: 用户ID。 取值范围: 32位uuid字符串。 |
userNumId |
String |
参数解释: 用户数字ID。 取值范围: 不涉及。 |
userName |
String |
参数解释: 用户名。 取值范围: 不涉及。 |
nickName |
String |
参数解释: 用户昵称。 取值范围: 不涉及。 |
summary |
String |
参数解释: 工作内容。 取值范围: 不涉及。 |
workDate |
String |
参数解释: 产生工时的日期。 取值范围: 不涉及。 |
workDateTimestamp |
String |
参数解释: 产生工时的日期时间戳。 取值范围: 不涉及。 |
workHours |
String |
参数解释: 实际工时(人/天) 取值范围: 不涉及 |
status |
Integer |
参数解释: 工时操作记录是否有效。 取值范围: 0(被删除); 1(记录有效)。 |
created |
String |
参数解释: 创建时间。 取值范围: 不涉及。 |
modified |
String |
参数解释: 修改时间。 取值范围: 不涉及。 |
region |
String |
参数解释: 区域。 取值范围: 不涉及。 |
batchIdentifier |
String |
参数解释: 同批次增加工作项工时记录的uuid。 取值范围: 32位uuid。 |
batchWorkHours |
String |
参数解释: 同批次添加工作项的总工时。 取值范围: 不涉及。 |
workHourTypeId |
Integer |
参数解释: 工时类型ID。 取值范围: 不涉及。 |
workHourTypeName |
String |
参数解释: 工时类型名称。 取值范围: 新建 编辑 删除 |
请求示例
PUT https://{endpoint}/v2/projects/919bb351ef424e2daaf3dd80c179fae9/issues/9049242/work_hours/383910e1483811f09df2fa163eed4f94 { "summary" : "图片上传功能开发。", "work_hours" : 0.5, "work_hour_type" : 27 }
响应示例
状态码:200
响应信息
{ "result": { "total": 1, "data": [ { "id": "ae6a11b27be511f0aa95fa163e60f658", "issueId": 69882126, "userId": "xxxxxx", "userNumId": 000000, "userName": "xxxxxx", "nickName": "xxxxxx", "summary": "", "workDate": "2025/08/18", "workDateTimestamp": "1755446400000", "workHours": "2.0" } ] }, "status": "success" }
状态码
状态码 |
描述 |
---|---|
200 |
响应信息 |
错误码
请参见错误码。