登记实际工时。
接口说明
登记实际工时。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /organization/{organizationId}/workitems/record
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| organizationId | string | 是 | 企业标识，也称企业 id，字符串形式，可在云效访问链接中获取，如 https://devops.aliyun.com/organization/【OrganizationId】 | 1e9903d8b3f1xxxxxf9286ef5 |
| body | object | 否 | 请求 Body | |
| workitemIdentifier | string | 是 | 工作项 id，即 workitemId | 9144ef6b72d8exxxxx9e61a4d0 |
| actualTime | string | 是 | 花费工时，最大为 9999 | 12 |
| type | string | 是 | 类型，从获取工时类型接口获取 | deafe5f33xxxxx6a259d8dafd |
| description | string | 否 | 描述 | 测试内容 |
| recordUserIdentifier | string | 是 | 登记人,为用户的 aliyunPk | 1316458xxxxx41068 |
| gmtStart | string | 是 | 开始时间 | 1667205617061 |
| gmtEnd | string | 是 | 结束时间，开始时间不能大于结束时间 | 1646323200000 |
返回参数
示例
正常返回示例
JSON格式
{
"requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
"errorMsg": "error",
"errorCode": "success",
"success": true,
"WorkitemTime": {
"identifier": "deafe5f33xxxxx6a259d8dafd",
"workitemIdentifier": "9144ef6b72d8exxxxx9e61a4d0",
"actualTime": 12,
"type": "deafe5f33xxxxx6a259d8dafd",
"description": "这是一段描述",
"recordUser": {
"account": "1316458xxxxx41068",
"identifier": "deafe5f33xxxxx6a259d8dafd",
"realName": "王五",
"nickName": "王武",
"avatar": "https://tcs-devops.aliyuncs.com/thumbnail/112m7150e256dbba0d6456bafbb65c81f90d/w/200/h/200",
"stamp": "null标识普通用户",
"nameEn": "wangwu",
"gender": "保留字段",
"mobile": "保留字段",
"email": "xxx@xxx.com",
"nickNamePinyin": "wangwu\n",
"realNamePinyin": "wangwu",
"displayNickName": "王五",
"displayRealName": "王五",
"displayName": "王五",
"dingTalkId": "xx12322",
"tbRoleId": "1e9903d8b3f1xxxxxf9286ef5",
"isDisabled": true
},
"gmtStart": 1667205617061,
"gmtEnd": 1667205617089
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Openapi.RequestError | request error | OpenAPI请求数据错误 |
| 403 | Operate.NoPermission | NoPermission | 没有权限 |
访问错误中心查看更多错误码。