任务

获取任务详情 分享链接 /book/api/717.html

作者:王怡栋 最后编辑:宋辰轩 于 2024-09-30 15:09:06 浏览量:9373
GET
/tasks/id

获取任务详情

请求URL

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

请求头

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

请求响应

名称 类型 必填 描述
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 string 创建人
openedDate datetime 创建时间
assignedTo string 指派给
assignedDate datetime 指派时间
estStarted date 预计开始日期
realStarted datetime 实际开始时间
finishedBy string 由谁完成
finishedDate datetime 完成时间
closedBy string 由谁关闭
closedDate datetime 关闭时间

响应示例

{
    "id": 22,
    "project": 41,
    "parent": 0,
    "execution": 42,
    "module": 0,
    "design": 0,
    "story": 0,
    "storyVersion": 1,
    "designVersion": 0,
    "fromBug": 0,
    "name": "多人任务",
    "type": "devel",
    "pri": 3,
    "estimate": 2,
    "consumed": 0,
    "left": 2,
    "deadline": "2021-12-23",
    "status": "wait",
    "subStatus": "",
    "color": "",
    "mailto": [],
    "desc": "",
    "version": 1,
    "openedBy": {
        "id": 1,
        "account": "admin",
        "avatar": "",
        "realname": "管理员"
    },
    "openedDate": "2021-12-05T12:00:57Z",
    "assignedTo": {
        "id": 1,
        "account": "admin",
        "avatar": "",
        "realname": "管理员"
    },
    "assignedDate": "2021-12-05T12:00:57Z",
    "estStarted": "2021-12-05",
    "realStarted": null,
    "finishedBy": null,
    "finishedDate": null,
    "finishedList": "",
    "canceledBy": null,
    "canceledDate": null,
    "closedBy": null,
    "closedDate": null,
    "planDuration": 0,
    "realDuration": 0,
    "closedReason": "",
    "lastEditedBy": null,
    "lastEditedDate": null,
    "activatedDate": "",
    "deleted": false,
    "storyID": null,
    "storyTitle": null,
    "latestStoryVersion": null,
    "storyStatus": null,
    "assignedToRealName": "管理员",
    "children": [],
    "team": [
        {
            "id": 50,
            "root": 22,
            "type": "task",
            "account": "admin",
            "role": "",
            "limited": "no",
            "join": "2021-12-05",
            "days": 0,
            "hours": 0,
            "estimate": 1,
            "consumed": 0,
            "left": 1,
            "order": 0,
            "realname": "管理员",
            "avatar": "",
            "progress": 0
        },
        {
            "id": 51,
            "root": 22,
            "type": "task",
            "account": "productManager",
            "role": "",
            "limited": "no",
            "join": "2021-12-05",
            "days": 0,
            "hours": 0,
            "estimate": 1,
            "consumed": 0,
            "left": 1,
            "order": 1,
            "realname": "产品经理",
            "avatar": "",
            "progress": 0
        }
    ],
    "files": [],
    "needConfirm": false,
    "progress": 0,
    "storySpec": "",
    "storyVerify": "",
    "storyFiles": [],
    "executionName": "testt",
    "moduleTitle": "/",
    "actions": [
        {
            "id": 1253748,
            "objectType": "task",
            "objectID": 22,
            "product": ",4,",
            "project": 41,
            "execution": 42,
            "actor": "管理员",
            "action": "opened",
            "date": "2021-12-05 20:00:57",
            "comment": "",
            "extra": "",
            "read": "1",
            "history": [],
            "desc": "2021-12-05 20:00:57, 由 <strong>管理员</strong> 创建。\n"
        }
    ],
    "preAndNext": {
        "pre": "",
        "next": ""
    }
}
评论列表
🏡
越狱的番茄 2024-11-19 14:16:44 回复
接口报错 error: error
回复
如何调用的,具体url,返回结果,禅道版本等信息都提供下呢
方便的话可以添加下页面上的联系方式,邀请进群后截图咨询下具体问题
📘
谦逊的板栗 2024-10-28 10:33:59 回复
请问一下。是不是没法通过接口,去修改任务描述 "desc" 字段?
回复
restful 接口中是不支持这个功能的。
禅道提供另外一种接口调用方式 zentaosid 方式,可以尝试一下 https://www.zentao.net/book/extension-dev/1341.html

它的工作原理是

1,获取用户sessionID
2,模拟浏览器的表单提交操作(可以到具体的页面通过浏览器发送的请求头,看参数名和参数值 , 附件的话也可以传递以数据流的方式)
🙊
戚辰先生 2024-05-30 16:51:27 回复
你好,developer,这个接口再版本18.10上面有吗?调用返回
{
"error": "not found"
}
回复
18.10有这个接口的
可以发一下调用接口的步骤呢
回复
curl --location 'http://xxx/zentao/api.php/v1/tokens' \
--header 'Content-Type: application/json' \
--header 'Cookie: device=desktop; lang=zh-cn; theme=default' \
--data '{
"account": "xxx",
"password": "xxx"
}'

curl --location --request GET 'http://xxx/zentao/api.php/v1//tasks/272' \
--header 'token: a1ff0d4c51da7ea9a0e865884faa21af' \
--header 'Content-Type: application/json' \
--header 'Cookie: device=desktop; lang=zh-cn; theme=default' \
--data '{
"account": "xxx",
"password": "xxx"
}'


调用了2个接口
一个token,一个详情
回复
request GET 'http://xxx/zentao/api.php/v1//tasks/272
这个里tasks前边多加了一个 /
码农 2022-08-15 16:56:27 回复
没有工时的使用者信息吗?就是哪些工时是由谁消耗的
回复
您好,我们禅道企业版和旗舰版是有日志功能的,可以维护记录工时消耗,开源版也可以通过插件实现,需要的话可以联系商务同事具体沟通下。
商务同事QQ:3142565561
张淑钧
高级客户经理
13156280939
2082428410
统一服务热线 4006-8899-23
我要提问提问有任何问题,您都可以在这里提问。 问题反馈反馈点击这里,让我们聆听您的建议与反馈。