主页 > API > 即将过期的任务


即将过期的任务

/v1/tasks/today
  • URL

    https://api.worktile.com/v1/tasks/today

  • HTTP请求方式

    GET

  • 支持格式

    JSON

    Header参数

    {
       "Content-Type":"application/json",
       "access_token":"xxx"
    }
    

    示例

    curl -l https://api.worktile.com/v1/tasks/today?access_token=xxx
    
  • HTTP请求参数

    参数 必选 类型 说明
    access_token true string OAuth授权后获得,请求时可放在header中
  • 返回数据

    示例

    HTTP/1.1 200 ok

    [ { "name":"task测试", "pid":"eda54f766b7f457ea7cdb5a93c6d892e", "tid":"db0895d9ce0a431ca9a75716212cdfc4", "entry_id":"906a3e739f1441088e89cad0655927d1", "entry_name":"呵呵呵", "created_at":"2014-10-29T11:43:20.294Z", "updated_at":"2015-03-23T08:49:38.518Z", "pos":65535, "labels":[ { "name":"blue", "desc":"需求" }, { "name":"purple", "desc":"哈哈" } ], "todos":[ { "todo_id":"7e395ed4667b4fadb9e5f3f12310ab05", "name":"检查项1", "checked":0, "pos":65535 }, { "todo_id":"c1bf8f86850f4534b89917836e5d3530", "name":"检查项2", "checked":0, "pos":131070 } ], "badges":{ "expire_date":"2014-10-30T15:59:59.999Z", "comment_count":1, "todo_checked_count":0, "todo_count":2, "file_count":0 }, "watchers":[ { "uid":"679efdf3960d45a0b8679693098135ff", "name":"gongmoumou", "display_name":"龚某某", "avatar":"default_avatar.png", "desc":"", "status":3, "online":0 }, { "uid":"d4745f9a9a6641c0a471182b6cdf909a", "name":"haifeng", "display_name":"徐海峰", "avatar":"5a69f6124d484f589996b1956126cf52.jpg", "desc":"我真的很靠谱1", "status":3, "online":0 } ], "members":[ { "uid":"679efdf3960d45a0b8679693098135ff", "name":"gongmoumou", "display_name":"龚某某", "avatar":"default_avatar.png", "desc":"", "status":3, "online":0 }, { "uid":"d4745f9a9a6641c0a471182b6cdf909a", "name":"haifeng", "display_name":"徐海峰", "avatar":"5a69f6124d484f589996b1956126cf52.jpg", "desc":"我真的很靠谱1", "status":3, "online":0 } ], "completed":1, "expire_date":"2014-10-30T15:59:59.999Z", "desc":"嘿嘿", "project":{ "pid":"eda54f766b7f457ea7cdb5a93c6d892e", "name":"Worktile 开发", "pic":"icon-github", "bg":"#5d8d0b" } } ]


    返回值字段 类型 说明
    name string 任务名称
    pid string 项目pid
    tid string 任务tid
    entry_id string 任务组id
    entry_name string 任务组名称
    created_at string 创建时间
    updated_at string 更新时间
    pos number 位置
    labels array 任务标签 详情 收起
        name string 标签名称
        desc string 标签描述
    todos array 检查项 详情 收起
        todo_id string 检查项id
        name string 检查项名称
        checked number 是否完成:0:未完成,1:完成
        pos number 检查项位置
    badges object 附加信息 详情 收起
        expire_date string 任务的截止日期
        comment_count number 任务评论数
        todo_checked_count number 检查项的完成数
        todo_count number 检查项个数
        file_count number 任务的附件个数
    watchers array 关注任务的成员 详情 收起
        uid string 关注任务的成员uid
        name string 关注任务的成员用户名
        display_name string 关注任务的成员昵称
        avatar string 关注任务的成员头像
        desc string 关注任务的成员说明
        status number 关注任务的成员状态:1:正常,2:邀请,3:需要邮件确认
        online number 成员的在线状态,0:离线,1:在线,2:忙碌,3:离开
    members array 任务分配的成员 详情 收起
        uid string 任务分配的成员uid
        name string 任务分配的成员用户名
        display_name string 任务分配的成员昵称
        avatar string 任务分配的成员头像
        desc string 任务分配的成员说明
        status number 任务分配的成员状态:1:正常,2:邀请,3:需要邮件确认
        online number 任务分配成员的在线状态,0:离线,1:在线,2:忙碌,3:离开
    completed number 是否完成:0:未完成,1:已完成
    expire_date string 截止日期
    desc string 任务描述
    project object 任务所在的项目 详情 收起
        pid string 项目pid
        name string 项目名称
        pic string 项目图标
        bg string 项目背景颜色
  • 异常结果

    示例

    HTTP/1.1 500 Server error

    { "error_code":600001, "error_message":"获取任务失败", "request":"/v1/tasks/today" }


    错误码(error_code) 错误信息(error_message) http状态码(statusCode)
    100005 未授权,请授权后再操作 401
    100006 access_token不正确 400
    600001 获取项目任务失败 500