迁移任务信息
POST
/topapi/workspace/task/migrate最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口迁移任务信息。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 否 | — | — |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端接口的授权凭证。第三方企业应用可通过调用get_corp_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
agentid
number
可选
微应用的agentId,可通过
task
object
请求入参。
source_id
string
必需
用于数据迁移的场景,表示任务在源系统中的唯一ID。ISV接入时必填,用于跳转至各自的任务详情页。
is_recycled
boolean
是否放入回收站。
gmt_modified
string
修改时间。
executor_userid
string
可选
执行者的userid,传staffId(工号)。
subject
string
任务标题。
is_archived
boolean
是否归档。
creator_userid
string
必需
创建者的userid,传staffId(工号)。
modifier_userid
string
可选
更新者的userid,传staffId(工号)。
description
string
任务描述。
priority
number
可选
优先级:10:较低20:普通30:紧急40:非常紧急
gmt_create
string
创建时间。
parent_id
string
父任务id。
task_type_id
number
任务类型id。
status_id
number
工作流状态id。
status_stage
number
可选
状态阶段:0:开始阶段1:进行阶段2:完成阶段
finish_date
string
任务实际完成时间。
start_date
string
任务实际开始日期。
corp_id
string
可选
任务所属项目(虚拟企业)。基于项目空间的项目。
task_type_category
string
可选
任务类型分类:TASK("task"): 任务REQ("req"):需求BUG("bug"):缺陷RISK("risk"):风险WORKITEM("workitem"):工作项
plan_start_date
string
任务计划开始时间。
plan_finish_date
string
任务计划完成时间。
tracker_userids
array[string]
可选
任务参与者列表,传staffId(工号)。
extension
object
任务的扩展字段。
source
string
可选
任务来源source。
operator_userid
string
必需
操作者的userid。
示例
{
"agentid": 868810166,
"operator_userid": "8456259",
"task": {
"source_id": "51ynzjcpw72k",
"is_recycled": false,
"gmt_modified": "2020-07-11 12:15:00",
"executor_userid": "user01",
"subject": "新人学习",
"creator_userid": "user02",
"modifier_userid": "user03",
"description": "迁移",
"priority": 10,
"gmt_create": "2020-07-11 12:12:12",
"parent_id": "11",
"status_stage": 1,
"corp_id": "dinge8a56572fxxxx"
}
}
示例代码
返回响应
成功(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
任务来源Id。
parent_id
string
父任务ID。
task_type_id
number
任务类型id。
status_id
number
工作流状态id。
executor_userid
string
可选
执行者的userid。
subject
string
任务标题。
gmt_modified
string
修改时间。
belong_corp_id
string
归属企业id。
corp_id
string
可选
任务所属项目(虚拟企业)。基于项目空间的项目。
task_id
string
任务ID。
task_type_category
string
可选
任务类型分类:TASK("task"): 任务REQ("req"):需求BUG("bug"):缺陷RISK("risk"):风险WORKITEM("workitem"):工作项
plan_start_date
string
任务计划开始时间。
plan_finish_date
string
任务计划完成时间。
tracker_userids
array[string]
任务参与者列表。
extension
object
任务的扩展字段。
source
string
可选
任务来源source。
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",
"belong_corp_id": "string",
"corp_id": "string",
"task_id": "string",
"task_type_category": "string",
"plan_start_date": "string",
"plan_finish_date": "string",
"tracker_userids": [
"string"
],
"extension": {
"comment_count": 0,
"file_path": "string",
"other": "string",
"systemProperty": {
"webUrl": "string",
"appUrl": "string"
}
},
"source": "string"
},
"errcode": 0,
"errmsg": "string"
}
最后修改时间: 2 年前