# 说明
返回视图下最新的30条任务(分页显示,默认一页30条)
# url
https://api.tapd.cn/tasks/get_tasks_by_view_conf_id
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
GET
# 请求数限制
默认返回 30 条。可通过传 limit 参数设置,最大取 200。也可以传 page 参数翻页
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
---|---|---|---|---|
view_conf_id | 是 | integer | 视图ID | |
workspace_id | 是 | integer | 项目ID | |
current_user | 否 | string | 当前登录用户视图 | |
limit | 否 | integer | 设置返回数量限制,默认为30 | |
page | 否 | integer | 返回当前数量限制下第N页的数据,默认为1(第一页) | |
fields | 否 | string | 设置获取的字段,多个字段间以','逗号隔开 |
# 调用示例及返回结果
# 获取项目下的任务数据
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/tasks/get_tasks_by_view_conf_id?view_conf_id=1010104801030259563&workspace_id=10104801'
# 返回结果
{
"status": 1,
"data": [
{
"Task": {
"id": "1010104801854821553",
"name": "xxxxxx",
"story_id": "0",
"iteration_id": "0",
"status": "open",
"effort": null,
"owner": "anyechen;",
"begin": null,
"due": null,
"workspace_id": "10104801"
}
}
],
"info": {
"total": 1,
"current_page": 1,
"page_size": 30,
"total_page": 1
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 任务字段说明
# 任务重要字段说明
字段 | 说明 |
---|---|
id | id |
name | 任务标题 |
description | 任务详细描述 |
workspace_id | 项目ID |
creator | 创建人 |
created | 创建时间 |
modified | 最后修改时间 |
status | 状态 |
owner | 任务当前处理人 |
cc | 抄送人 |
begin | 预计开始 |
due | 预计结束 |
release_id | 发布计划ID |
story_id | 关联需求的ID |
iteration_id | 所属迭代的ID |
priority | 优先级 |
progress | 进度 |
completed | 完成时间 |
effort_completed | 完成工时 |
exceed | 超出工时 |
remain | 剩余工时 |
effort | 预估工时 |
# 任务状态(status)取值字段说明
取值 | 字面值 |
---|---|
open | 未开始 |
progressing | 进行中 |
done | 已完成 |
# 任务优先级(priority)取值字段说明
取值 | 字面值 |
---|---|
4 | High |
3 | Middle |
2 | Low |
1 | Nice To Have |