任务

添加任务日志

作者：宋辰轩最后编辑：宋辰轩于 2024-09-30 15:12:03 浏览量：12290 分享链接

POST

/tasks/id/estimate

添加任务日志

请求URL

https://xxx.com/api.php/v1/tasks/id/estimate

请求头

名称	类型	必填	描述
Token	String	是	认证凭证Token

请求体

对于禅道开源版20.7（企业版10.6、旗舰版5.6、IPD版2.6）之前的版本，使用下面的请求体

名称	类型	必填	描述
id	array	是	从0自增，表示记录几条日志，如3条日志则填入 [0,1,2]
objectID	array	是	任务ID
dates	array	是	日期
work	array	是	工作内容
consumed	array	是	消耗
left	array	是	剩余
objectType	array	是	对象类型，此处填入task

对于禅道开源版20.7（企业版10.6、旗舰版5.6、IPD版2.6）及之后的版本，使用下面的请求体

名称	类型	必填	描述
date	array	是	日期
work	array	是	工作内容
consumed	array	是	消耗
left	array	是	剩余

请求示例

对于禅道开源版20.7（企业版10.6、旗舰版5.6、IPD版2.6）之前的版本，使用下面的请求示例

{
    "id": [0,1,2],
    "objectID": [2,2,2],
    "dates": ["2024-02-27","2024-02-28","2024-02-29"],
    "work": ["work1","work2","work3"],
    "consumed": [2,2,2],
    "left": [6,4,2],
    "objectType": ["task","task","task"]
}

对于禅道开源版20.7（企业版10.6、旗舰版5.6、IPD版2.6）及之后的版本，使用下面的请求示例

{
    "date": ["2024-02-27","2024-02-28","2024-02-29"],
    "work": ["work1","work2","work3"],
    "consumed": [2,2,2],
    "left": [6,4,2]
}

请求响应

名称	类型	必填	描述
id	int	是	任务ID
project	int	是	所属任务
parent	int	是	父任务
execution	int	是	所属执行
module	int	是	所属模块
story	int	是	关联需求
fromBug	int	是	来源于Bug
name	string	是	任务名称
type	string	是	任务类型(design 设计 \| devel 开发 \| request 需求 \| test 测试 \| study 研究 \| discuss 讨论 \| ui 界面 \| affair 事务 \| misc 其他)
pri	int	是	优先级
estimate	float	是	预计工时
consumed	float	是	消耗工时
left	float	是	剩余工时
deadline	date	是	预计结束日期
status	string	是	状态(wait 未开始 \| doing 进行中 \| done 已完成 \| closed 已关闭 \| cancel 已取消)
desc	string	是	任务描述
openedBy		是	创建人
openedDate	datetime	是	创建时间
assignedTo		是	指派给
assignedDate	datetime	是	指派时间
estStarted	date	是	预计开始日期
realStarted	datetime	否	实际开始时间
finishedBy	string	否	由谁完成
finishedDate	datetime	否	完成时间
closedBy		否	由谁关闭
closedDate	datetime	否	关闭时间
team	array	是	团队，应用于多人任务

响应示例

{
    "id": 2,
    "project": 1,
    "parent": 0,
    "execution": 2,
    "module": 0,
    "design": 0,
    "story": 0,
    "storyVersion": 1,
    "designVersion": 0,
    "fromBug": 0,
    "feedback": 0,
    "fromIssue": 0,
    "name": "testtt",
    "type": "devel",
    "mode": "",
    "pri": 0,
    "estimate": 0,
    "consumed": 6,
    "left": 2,
    "deadline": "2024-04-31",
    "status": "doing",
    "subStatus": "",
    "color": "",
    "mailto": null,
    "desc": "",
    "version": 1,
    "openedBy": "admin",
    "openedDate": "2024-02-02T05:08:49Z",
    "assignedTo": "admin",
    "assignedDate": "2024-02-02T07:55:26Z",
    "estStarted": "2024-02-01",
    "realStarted": "2024-02-02T06:04:59Z",
    "finishedBy": "admin",
    "finishedDate": "2024-02-02T07:45:27Z",
    "finishedList": "",
    "canceledBy": "",
    "canceledDate": null,
    "closedBy": "",
    "closedDate": null,
    "planDuration": 0,
    "realDuration": 1,
    "closedReason": "",
    "lastEditedBy": "admin",
    "lastEditedDate": "2024-02-02T07:55:26Z",
    "activatedDate": "",
    "order": 0,
    "repo": 0,
    "mr": 0,
    "entry": "",
    "lines": "",
    "v1": "",
    "v2": "",
    "deleted": "0",
    "vision": "rnd",
    "storyID": null,
    "storyTitle": null,
    "latestStoryVersion": null,
    "storyStatus": null,
    "assignedToRealName": "admin",
    "children": [],
    "members": [],
    "team": [],
    "files": [],
    "needConfirm": false,
    "progress": 80
}