云服务器内容精选

  • 响应示例 状态码: 200 ok { "added_work_hours" : [ { "work_hours_id" : "7da14cf9f3c111eda5a5fa163ec9f6c1", "issue_id" : 123456, "user_name" : "user_name", "user_nick_name" : "O_O", "work_date" : "2023-05-15", "work_hours" : "2.0", "work_hours_type_name" : "研发设计" } ] }
  • 请求示例 Post https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb2/issues/123456/work-hours { "start_date" : "2023-05-15", "due_date" : "2023-05-15", "work_hours" : 2.0, "work_hours_type_id" : 21 }
  • URI POST /v4/projects/{project_id}/issues/{issue_id}/work-hours 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释:项目的32位uuid,项目唯一标识,可以通过ListProjectsV4接口查询项目列表 约束限制:正则表达式, ^[A-Za-z0-9]{32}$ 取值范围:字符串,最小长度:32,最大长度:32 默认取值:不涉及 issue_id 是 Integer 参数解释:工作项id,可通过ListIssuesV4接口高级查询工作项 约束限制:正则表达式,[0-9]{1,10}$ 取值范围:最小长度:1,最大长度:10 默认取值:不涉及
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释:用户Token。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制:不涉及 取值范围:最小长度:10,最大长度:32768 默认取值:不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 start_date 是 String 参数解释:工时开始日期,年-月-日 约束限制:正则表达式, ^\d{4}-\d{2}-\d{2}$ 取值范围:匹配格式为 YYYY-MM-DD 的日期字符串,MM 是两位数的月份限制取值01-12,DD是两位数的日期限制取值01-31 默认取值:不涉及 due_date 是 String 参数解释:工时结束日期,年-月-日 约束限制:正则表达式, ^\d{4}-\d{2}-\d{2}$ 取值范围:匹配格式为 YYYY-MM-DD 的日期字符串,MM 是两位数的月份限制取值01-12,DD是两位数的日期限制取值01-31 默认取值:不涉及 work_hours 是 Double 参数解释:工时总数(若工时日期范围包含多天,单日工时将设为“工时总数/天数”) 约束限制:不涉及 取值范围:最小值:0.0,最大值:100000000 默认取值:不涉及 work_hours_type_id 否 Integer 参数解释:工时类型id (项目预设工时类型id及名称对照:21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App), 26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假) 约束限制:不涉及 取值范围:最小值:21,最大值:34 默认取值:不涉及
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 added_work_hours Array of added_work_hours objects 已添加的工时列表 表5 added_work_hours 参数 参数类型 描述 work_hours_id String 工时id issue_id Integer 添加工时对应的工作项id user_name String 工时添加用户的用户名 user_nick_name String 工时添加用户的用户昵称 work_date String 工时日期 年-月-日 work_hours Double 工时数 work_hours_type_name String 工时类型名称 (项目预设工时类型id及名称对照:21:研发设计,22:后端开发,23:前端开发(Web),24:前端开发(小程序),25:前端开发(App), 26:测试验证,27:缺陷修复,28:UI设计,29:会议,30:公共事务,31:培训,32:研究,33:其它,34:调休请假) 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码: 401 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码