# 说明

返回用户待办的任务（分页显示，默认一页30条）

# url

https://api.tapd.cn/user_oauth/get_user_todo_task

# 支持格式

JSON/XML（默认JSON格式）

# HTTP请求方式

GET

# 请求数限制

仅支持用户态 OAuth Access Token 调用
默认返回 30 条。可通过传 limit 参数设置，最大取 200。也可以传 page 参数翻页

# 请求参数

字段名	必选	类型及范围	说明	特殊规则
workspace_id	`是`	integer	项目ID
user	否	string	用户
limit	否	integer	设置返回数量限制，默认为30
page	否	integer	返回当前数量限制下第N页的数据，默认为1（第一页）
order	否	string	排序规则，规则：字段名 ASC或者DESC，然后 urlencode	如按创建时间逆序：order=created%20desc
fields	否	string	设置获取的字段，多个字段间以','逗号隔开

# 调用示例及返回结果

# 返回用户待办的任务

# 返回结果

{
    "status": 1,
    "data": [
        {
            "Task": {
                "id": "1010158231500706019",
                "name": "复制的xxxxxxx",
                "owner": "anyechen;"
            }
        },
        {
            "Task": {
                "id": "1010158231500687937",
                "name": "story_created_by_api",
                "owner": "anyechen;"
            }
        },
        {
            "Task": {
                "id": "1010158231500625827",
                "name": "官网登录页改造",
                "owner": "anyechen;"
            }
        }
    ],
    "info": "success"
}

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
26
27

# 任务字段说明

# 任务重要字段说明

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

← 返回用户待办的缺陷添加工作项 →