# 说明

返回视图下最新的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
上次更新: 2022-12-09 15:46:12