增加工作项工时记录V3
功能介绍
增加工作项工时记录。
调用方法
请参见如何调用API。
URI
POST /v3/projects/{project_uuid}/issues/{issue_id}/work-hours
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 最小长度:10,最大长度:32768。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
start_date_timestamp |
否 |
Integer |
参数解释: 开始时间,时间戳格式(示例:1839340800000)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
due_date_timestamp |
否 |
Integer |
参数解释: 截止时间,时间戳格式(示例:1839340800000)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
start_date |
否 |
String |
参数解释: 开始时间,时间格式(格式:yyyy-MM-dd,示例:2025-07-25)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
due_date |
否 |
String |
参数解释: 截止时间,时间格式(格式:yyyy-MM-dd,示例:2025-07-25)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
use_timestamp |
否 |
Boolean |
参数解释: 是否使用时间戳。 约束限制: 不涉及。 取值范围: true(是) false(不是) 默认取值: 不涉及。 |
|
work_hours |
否 |
Integer |
参数解释: 工时(单位:人/时)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
include_weekends |
否 |
Integer |
参数解释: 工时是否包含周末。 约束限制: 不涉及。 取值范围: 0(不包含) 1(包含) 默认取值: 不涉及。 |
|
type |
否 |
Integer |
参数解释: 时间区间总工时。 约束限制: 不涉及。 取值范围: 0(时间区间总计8小时) 1(每天8小时) 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
result object |
参数解释: 返回结果。 |
|
status |
String |
参数解释: 返回状态。 取值范围: success:返回成功。 error:返回失败。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 工时记录id。 取值范围: 不涉及。 |
|
issue_id |
Integer |
参数解释: 工作项id。 取值范围: 不涉及。 |
|
user_id |
String |
参数解释: 用户id。 取值范围: 不涉及。 |
|
user_num_id |
Integer |
参数解释: 用户数字id。 取值范围: 不涉及。 |
|
user_name |
String |
参数解释: 用户名称。 取值范围: 不涉及。 |
|
nick_name |
String |
参数解释: 用户昵称。 取值范围: 不涉及。 |
|
work_date |
String |
参数解释: 工作时间,时间格式(格式:yyyy/MM/dd,示例:2025/07/25)。 取值范围: 不涉及。 |
|
work_date_timestamp |
String |
参数解释: 工作时间,时间戳格式(示例:1839340800000)。 取值范围: 不涉及。 |
|
work_hours |
String |
参数解释: 工时(单位:人/时)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
region |
String |
参数解释: 区域。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求示例
/v3/projects/381fcca9c056482d92da3e8b9da71db5/issues/69813204/work-hours
{
"start_date_timestamp" : 1753372800000,
"due_date_timestamp" : 1753459199999,
"start_date" : "2025-07-25",
"due_date" : "2025-07-25",
"use_timestamp" : true,
"work_hours" : 1,
"include_weekends" : 0,
"type" : 0
}
响应示例
状态码:200
添加工作项工时接口成功的响应。
{
"result" : {
"list" : [ {
"id" : "78c74003692311f0aa95fa163e60f658",
"issue_id" : 69813204,
"user_id" : "073a9e23188025b31f06c0104a74c376",
"user_num_id" : 233087,
"user_name" : "hw_008618814464665_01",
"nick_name" : "asdf4",
"work_date" : "2025/07/25",
"work_date_timestamp" : "1753372800000",
"work_hours" : "1.0",
"region" : "example"
} ]
},
"status" : "success"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
添加工作项工时接口成功的响应。 |
错误码
请参见错误码。