• 返回用户待办的任务
  • curl 使用 OAuth Access Token 鉴权调用示例
  • 返回结果
• 任务重要字段说明
• 任务状态(status)取值字段说明
• 任务优先级(priority)取值字段说明

说明

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

url

http://apiv2.tapd.oa.com/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	设置获取的字段，多个字段间以','逗号隔开

调用示例及返回结果

返回用户待办的任务

curl 使用 OAuth Access Token 鉴权调用示例

curl -H 'Authorization: Bearer ACCESS_TOKEN' 'http://apiv2.tapd.oa.com/user_oauth/get_user_todo_task?workspace_id=10158231&user=anyechen&fields=id,name,owner'

返回结果

{
    "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"
}

任务字段说明

任务重要字段说明

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