# 说明

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

# url

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

# 支持格式

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": [
        {
            "Story": {
                "id": "1010158231500706019",
                "name": "复制的xxxxxxx",
                "owner": "anyechen;"
            }
        },
        {
            "Story": {
                "id": "1010158231500687937",
                "name": "story_created_by_api",
                "owner": "anyechen;"
            }
        },
        {
            "Story": {
                "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	标题
priority	优先级
business_value	业务价值
status	状态
version	版本
module	模块
test_focus	测试重点
size	规模
owner	处理人
cc	抄送人
creator	创建人
developer	开发人员
lastmodify	最后修改人
begin	预计开始
due	预计结束
created	创建时间
modified	最后修改时间
completed	完成时间
iteration_id	迭代
effort	预估工时
effort_completed	完成工时
remain	剩余工时
exceed	超出工时
category_id	需求分类
release_id	发布计划
source	来源
type	类型
parent_id	父需求
children_id	子需求
description	详细描述
workspace_id	项目ID
workitem_type_id	需求类别

# 需求优先级(priority)取值字段说明

取值	字面值
4	High
3	Middle
2	Low
1	Nice To Have

← 获取当前用户需求视图列表返回用户待办的缺陷 →