任務管理 · 任務系統API文檔

[TOC] ## 創建任務 ~~~[api] post:/task/create <<< 請求內容 { "project_id": 1000, // 項目ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "pre_task_id": 3 // 前置任務 0表示無前置任務 } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 創建時間 "info": "張三創建了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 任務詳情 ~~~[api] post:/task/detail <<< 請求內容 { "id": 1000 // 任務ID } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 編輯任務 ~~~[api] post:/task/update <<< 請求內容 { "id": 1000, // 任務ID "project_id": 1000, // 項目ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "pre_task_id": 0 // 前置任務僅當任務狀態為不可用或待分配時可修改 } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 分配任務 ~~~[api] post:/task/dispatch <<< 請求內容 { "id": 1000, // 任務ID "user_id": 1 // 用戶ID } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 評估任務 ~~~[api] post:/task/expect <<< 請求內容 { "id": 1000, // 任務ID "expected_hour": 1 // 預估工時 } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 提交任務 ~~~[api] post:/task/submit <<< 請求內容 { "id": 1000, // 任務ID "used_hour": 1 // 完成工時 } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 審核任務 ~~~[api] post:/task/review <<< 請求內容 { "id": 1000, // 任務ID "review": 1 // 審核 0-未通過，1-通過 } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 轉交任務 ~~~[api] post:/task/transfer <<< 請求內容 { "id": 1000, // 任務ID "user_id": 1 //用戶ID } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md) ## 關閉任務 ~~~[api] post:/task/close <<< 請求內容 { "id": 1000 // 任務ID } <<< 返回結果 { "code": 0, "info": "success", "data": { "id": 1000, // 任務ID "name": "登錄頁", // 任務名稱 "info": "完成登錄頁面", // 任務描述 "priority": 1, // 優先級 "state": 1, // 狀態 "expected_hour": 2, // 預估工時 "used_hour": 3, // 完成工時 "create_time": "2018-05-20 12:20:22", // 創建時間 "complete_time": null, // 完成時間 "project": // 所屬項目 { "id": 1001, // 項目ID "name": "任務系統" // 項目名稱 }, "pre_task": // 前置任務 { "id": 1001, // 任務ID "name": "路由配置" // 任務名稱 }, "creator": // 創建人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "executor": // 執行人 { "id": 1001, // 用戶ID "name": "張三" // 用戶名稱 }, "logs": [ // 任務日志 { "create_time": "2018-05-20 12:20:22", // 記錄時間 "info": "張三創建了任務" // 日志描述 }, { "create_time": "2018-05-20 12:22:22", // 記錄時間 "info": "張三編輯了任務" // 日志描述 } ] } } ~~~ 錯誤參見[錯誤碼說明](錯誤碼說明.md)