文档首页/ 需求管理 CodeArts Req/ API参考/ API/ OpenAPI管理/ 创建工时
更新时间：2024-11-30 GMT+08:00
查看PDF
分享

创建工时

功能介绍

创建工时

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1/ipdprojectservice/projects/{project_id}/work-items/{workitem_id}/work-hour

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id

workitem_id

是

String

工作项id

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

work_hour_category

否

String

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

work_date_begin

是

String

工时开始日期

work_date_end

是

String

工时结束日期

work_hours

是

String

工时数值

work_hour_type

是

String

工时类型：1：总数 2：每天

include_weekend

是

Boolean

是否包含周末

description

否

String

描述

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

status

String

状态

message

String

消息

result

WorkHourTotalVO object

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

参数

参数类型

描述

data

Array of WorkHourVO objects

工时信息列表

work_hours_total

String

实际工时总数
表5 WorkHourVO

参数

参数类型

描述

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

花费工时(人天)
表6 UserEntity

参数

参数类型

描述

id

String

用户Id

name

String

用户名称

nick_name

String

用户昵称

状态码： 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

创建总数为100，开始时间从2024/02/01至2024/02/06，工时类型为研发设计，包含周末的工时数据

{url}/v1/ipdprojectservice/projects/05c7d8bcf3db4829bc841e4ba93aaea5/work-items/976857692367659008/work-hour?_=1708329665577

{
  "work_hour_category" : "研发设计",
  "work_date_begin" : "2024/02/01",
  "work_date_end" : "2024/02/02",
  "work_hours" : "12",
  "work_hour_type" : 1,
  "include_weekend" : true,
  "description" : "工作内容工作内容工作内容"
}

响应示例

无

状态码

状态码

描述

200

创建工时返回体

400

失败返回体

错误码

请参见错误码。

父主题： OpenAPI管理

相关文档