文档

ListWorkitemTime - 获取工作项工时明细列表

更新时间:

获取工作项工时明细列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /organization/{organizationId}/workitems/{workitemId}/time/list

请求参数

名称类型必填描述示例值
organizationIdstring

企业标识,也称企业 id,字符串形式,可在云效访问链接中获取,如 https://devops.aliyun.com/organization/【OrganizationId】

5ebbc0228123212b59xxxxx
workitemIdstring

工作项 id,同 workitemIdentifier 字段,工作项唯一标识

5daa9a15c7fd55523996......

返回参数

名称类型描述示例值
object
requestIdstring

请求 id,每次请求都是唯一值,便于后续排查问题

ASSDS-ASSASX-XSAXSA-XSAXSAXS
errorMsgstring

错误信息

error
errorCodestring

错误码

Openapi.RequestError
successboolean

true 或者 false

true
workitemTimearray<object>

工时信息

object
workitemIdentifierstring

工作项 id,唯一标识

5daa9a15c7fd55523996......
identifierstring

工时唯一标识

a4ac3a81e90217db32b7......
gmtStartlong

开始时间

1653235200000
gmtEndlong

结束时间

1653235200000
actualTimefloat

实际工时,精度到小数点后一位

1
typestring

工时类型,如设计、研发、测试、文档、其他

研发
descriptionstring

工时描述信息

开发代码等
recordUserstring

登记人的 account Id

1967043931......
gmtCreatelong

工时记录的创建时间

1653235200000
gmtModifiedlong

工时记录的修改时间

1653235200000
codelong

接口返回 code

200

示例

正常返回示例

JSON格式

{
  "requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
  "errorMsg": "error",
  "errorCode": "Openapi.RequestError",
  "success": true,
  "workitemTime": [
    {
      "workitemIdentifier": "5daa9a15c7fd55523996......",
      "identifier": "a4ac3a81e90217db32b7......",
      "gmtStart": 1653235200000,
      "gmtEnd": 1653235200000,
      "actualTime": 1,
      "type": "研发",
      "description": "开发代码等",
      "recordUser": "1967043931......",
      "gmtCreate": 1653235200000,
      "gmtModified": 1653235200000
    }
  ],
  "code": 200
}

错误码

HTTP status code错误码错误信息描述
400Openapi.RequestErrorrequest errorOpenAPI请求数据错误
403Operate.NoPermissionNoPermission没有权限

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-12-05OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情