调用CreateWorkitemRecord登记实际工时_云效(Apsara Devops)-阿里云帮助中心

登记实际工时。

接口说明

登记实际工时。

调试

您可以在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

返回参数

名称	类型	描述	示例值
	object	Schema of Response
requestId	string	Id of the request	ASSDS-ASSASX-XSAXSA-XSAXSAXS
errorMsg	string	错误信息。	error
errorCode	string	当 success 为 false，返回业务错误码；当 success 为 true，返回空值。	success
success	boolean	true 接口调用成功，false 接口调用失败	true
WorkitemTime	object	工作时间
identifier	string	工时唯一标识	deafe5f33xxxxx6a259d8dafd
workitemIdentifier	string	工作项 id	9144ef6b72d8exxxxx9e61a4d0
actualTime	long	实际工时，小时为单位	12
type	string	工时类型，通过获取工时类型接口获得	deafe5f33xxxxx6a259d8dafd
description	string	描述	这是一段描述
recordUser	object	登记人相关信息
account	string	阿里云账号	1316458xxxxx41068
identifier	string	用户 id	deafe5f33xxxxx6a259d8dafd
realName	string	用户实际名	王五
nickName	string	用户昵称	王武
avatar	string	用户头像	https://tcs-devops.aliyuncs.com/thumbnail/112m7150e256dbba0d6456bafbb65c81f90d/w/200/h/200
stamp	string	普通用户或者用户组	null标识普通用户
nameEn	string	用户英文名	wangwu
gender	string	性别	保留字段
mobile	string	电话号码	保留字段
email	string	邮箱地址	xxx@xxx.com
nickNamePinyin	string	昵称拼音	wangwu
realNamePinyin	string	实际姓名拼音	wangwu
displayNickName	string	展示的昵称	王五
displayRealName	string	展示的实际名	王五
displayName	string	展示名	王五
dingTalkId	string	钉钉 id	xx12322
tbRoleId	string	角色 id	1e9903d8b3f1xxxxxf9286ef5
isDisabled	boolean	是否可见	true/false
gmtStart	long	开始时间	1667205617061
gmtEnd	long	结束时间	1667205617089

示例

正常返回示例

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	没有权限

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史