查询任务详情
POST
/topapi/workspace/task/get最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口根据任务ID查询任务详情。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 否 | — | — |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端接口的授权凭证。第三方企业应用可通过调用get_corp_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
microapp_agent_id
number
可选
微应用的agentId。
task_id
string
必需
任务ID,可通过获取任务详情接口获取。
示例
{
"microapp_agent_id": 868810166,
"task_id": "pushW1YI2SswiEiExxxx"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
object
查询结果。
gmt_create
string
创建时间。
modifier_userid
string
可选
更新者userid。
creator_userid
string
可选
创建者userid。
biz_tag
string
业务标识。
priority
number
可选
优先级:10:较低20:普通30:紧急40:非常紧急
description
string
任务描述。
finish_date
string
任务实际完成时间。
start_date
string
任务实际开始日期。
is_recycled
boolean
是否放入回收站。
is_archived
boolean
是否归档。
status_stage
number
可选
状态阶段:0:开始阶段1:进行阶段2:完成阶段
source_id
string
可选
任务来源sourceId。
parent_id
string
父任务id。
task_type_id
number
任务类型id。
status_id
number
工作流状态id。
executor_userid
string
可选
执行者的userid。
subject
string
任务标题。
gmt_modified
string
修改时间。
corp_id
string
可选
任务所属项目(虚拟企业)。基于项目空间的项目。
belong_corp_id
string
归属企业id。
task_type_category
string
可选
任务类型分类:TASK("task"): 任务REQ("req"):需求BUG("bug"):缺陷RISK("risk"):风险WORKITEM("workitem"):工作项
task_id
string
任务id。
plan_start_date
string
任务计划开始时间。
plan_finish_date
string
任务计划完成时间。
tracker_userids
array[string]
任务参与者列表。
extension
object
任务的扩展字段。
errcode
number
返回码。
errmsg
string
返回码描述。
示例
{
"result": {
"gmt_create": "string",
"modifier_userid": "string",
"creator_userid": "string",
"biz_tag": "string",
"priority": 0,
"description": "string",
"finish_date": "string",
"start_date": "string",
"is_recycled": true,
"is_archived": true,
"status_stage": 0,
"source_id": "string",
"parent_id": "string",
"task_type_id": 0,
"status_id": 0,
"executor_userid": "string",
"subject": "string",
"gmt_modified": "string",
"corp_id": "string",
"belong_corp_id": "string",
"task_type_category": "string",
"task_id": "string",
"plan_start_date": "string",
"plan_finish_date": "string",
"tracker_userids": [
"string"
],
"extension": {
"comment_count": "string",
"file_path": "string",
"other": "string"
}
},
"errcode": 0,
"errmsg": "string"
}
最后修改时间: 2 年前