YesDev / WebAPI / 获取任务详情

获取任务详情

接口描述: 获取任务详情

HTTP/HTTPS
请求协议
GET/POST
请求方式
UTF-8
编码格式
JSON
返回格式

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口
app_key字符串可选app_key,团队代码
sign字符串可选-动态签名,签名算法请联系我们技术客服获取
id整型必须-最小:1任务ID
is_have_need整型可选0是否需求返回需求,默认不需要返回关联的需求,1需要返回关联的需求
is_have_project整型可选0是否需求返回项目,默认不需要返回关联的项目,1需要返回关联的项目
is_have_problem整型可选0是否需求返回问题,默认不需要返回关联的问题,1需要返回关联的问题
is_record_staff_historical_update_version整型可选0是否后端保存该成员的当前版本

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
data.id整型
data.task_title字符串任务标题
data.task_type整型任务类型,0其他1UI设计2产品原型3技术开发4测试5会议6编写文档7调研8沟通
data.task_timedouble任务工时评估,单位:小时,保留一位小数
data.task_finish_time字符串完成时间
data.task_status整型任务状态,0待办,1已开始,2已完成
data.项目IDproject_id
msg字符串提示信息,失败时的错误提示

在线测试   

参数是否必须
service 必须
access_token 可选
app_key 可选
sign 可选
id 必须
is_have_need 可选
is_have_project 可选
is_have_problem 可选
is_record_staff_historical_update_version 可选

客户端请求示例

{
    "ret": 200,
    "data": {
        "id": 2,
        "task_title": "技术评审",
        "task_type": 0,
        "admin_id": 1,
        "task_time": "0.0",
        "task_finish_time": null,
        "task_status": 0,
        "project_id": 0,
        "app_key": "gc",
        "add_time": "2020-10-27 17:34:19",
        "staff_id": 10
    },
    "msg": ""
}

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
410权限不足
500表示服务端内部错误

本文档生成时间:2024-04-27 13:49:30 联系我们开通接入OpenAPI