# 说明

返回视图下最新的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

# 任务字段说明

# 任务重要字段说明

字段	说明
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

← 获取回收站下的任务获取任务字段信息 →