主页 > API > 添加检查项


添加检查项

/v1/tasks/:tid/todo
  • URL

    https://api.worktile.com/v1/tasks/:tid/todo

  • HTTP请求方式

    POST

  • 支持格式

    JSON

    Header参数

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

    示例

    curl -d 'name=检查项' 'https://api.worktile.com/v1/tasks/adsa7sa6/todo?pid=xxx&access_token=xxx' 
    
  • HTTP请求参数

    参数 必选 类型 说明
    tid true string 任务tid
    pid true string 项目pid
    access_token true string OAuth授权后获得,请求时可放在header中
    name true string 检查项内容
  • 返回数据

    示例

    HTTP/1.1 200 ok

    { "todo_id":"3486ead769674ed5913d442fb4e6a1f4", "name":"检查项", "pos":0, "checked":0 }


    返回值字段 类型 说明
    todo_id string 检查项id
    name string 检查项内容
    pos number 检查项位置
    checked number 是否完成:0:未完成,1:已完成
  • 异常结果

    示例

    HTTP/1.1 400 Bad Request

    { "error_code":600020, "error_message":"任务检查项内容为空", "request":"/v1/tasks/:tid/todo" }


    错误码(error_code) 错误信息(error_message) http状态码(statusCode)
    100005 没授权,请授权后再操作 401
    100006 access_token不正确 400
    600020 任务检查项内容为空 400
    600021 任务添加检查项失败 500