任务

研发与测试任务管理 - 所有与研发和测试相关任务的统一管理入口

---

开始任务

PUT

/api/v1/task/{id}/start

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/start

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

查询未关联任务的任务列表

GET

/api/v1/task/{id}/task/notAssociated

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

moduleId

模块ID

类型integer

格式"int64"

taskType

任务类型

类型string

有效值

"REQUIREMENT""STORY""TASK""BUG""API_TEST""SCENARIO_TEST"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/task/{id}/task/notAssociated

试验场

授权

UserHttpBearer

变量

键

值

id*

moduleId

taskType

示例

cURL

JavaScript

PHP

Python

---

替换任务的评估工作负载

PUT

/api/v1/task/{id}/evalWorkload

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/evalWorkload

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

替换任务软件版本

PUT

/api/v1/task/{id}/software/version

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/software/version

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

取消任务

PUT

/api/v1/task/{id}/cancel

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/cancel

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

替换任务名称

PUT

/api/v1/task/{id}/name

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

name*

新任务名称

类型string

必填

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/name

试验场

授权

UserHttpBearer

变量

键

值

id*

name*

示例

cURL

JavaScript

PHP

Python

---

替换任务负责人

PUT

/api/v1/task/{id}/assignee

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/assignee

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

替换任务的缺陷等级

PUT

/api/v1/task/{id}/bugLevel

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

bugLevel*

缺陷等级

类型string

必填

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/bugLevel

试验场

授权

UserHttpBearer

变量

键

值

id*

bugLevel*

示例

cURL

JavaScript

PHP

Python

---

替换任务中的附件

PUT

/api/v1/task/{id}/attachment

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/attachment

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

对任务列表进行全文搜索

GET

/api/v1/task/search

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

projectId*

项目ID

类型integer

必填

格式"int64"

id

任务ID

类型integer

格式"int64"

name

任务名称

类型string

code

任务代码

类型string

softwareVersion

任务软件的版本

类型string

sprintId

任务迭代ID

类型integer

格式"int64"

moduleId

任务模块ID

类型integer

格式"int64"

backlog

积压工作标志。true：冲刺积压工作，false：产品积压工作

类型boolean

targetId

与该任务关联的场景或API ID

类型integer

格式"int64"

targetParentId

与该任务关联的场景目录或服务ID

类型integer

格式"int64"

taskType

任务类型

类型string

有效值

"REQUIREMENT""STORY""TASK""BUG""API_TEST""SCENARIO_TEST"

bugLevel

缺陷等级

类型string

有效值

"CRITICAL""MAJOR""MINOR""TRIVIAL"

testType

任务测试类型

类型string

有效值

"PERFORMANCE""FUNCTIONAL""STABILITY""CUSTOMIZATION"

assigneeId

经办人ID

类型integer

格式"int64"

confirmorId

确认者ID

类型integer

格式"int64"

testerId

测试者ID

类型integer

格式"int64"

missingBug

缺失的错误标志

类型boolean

unplanned

类型boolean

parentTaskId

任务父级ID

类型integer

格式"int64"

tagId

标签ID

类型integer

格式"int64"

priority

任务优先级

类型string

有效值

"HIGHEST""HIGH""MEDIUM""LOW""LOWEST"

evalWorkload

任务评估工作量

类型number

actualWorkload

任务实际工作量

类型number

status

任务状态

类型string

有效值

"PENDING""IN_PROGRESS""CONFIRMING""COMPLETED""CANCELED"

overdue

任务是否逾期

类型boolean

failNum

任务失败数量

类型integer

格式"int32"

totalNum

已处理的任务数量

类型integer

格式"int32"

execId

执行ID

类型integer

格式"int64"

execBy

执行用户ID

类型integer

格式"int64"

execResult

任务执行结果

类型string

有效值

"SUCCESS""FAIL"

startDate

任务开始日期

类型string

格式"date-time"

deadlineDate

任务截止日期

类型string

格式"date-time"

confirmedDate

任务确认日期

类型string

格式"date-time"

completedDate

任务完成日期

类型string

格式"date-time"

processedDate

任务处理日期

类型string

格式"date-time"

canceledDate

任务取消日期

类型string

格式"date-time"

execDate

任务执行日期

类型string

格式"date-time"

createdBy

任务创建者

类型integer

格式"int64"

createdDate

任务创建日期

类型string

格式"date-time"

lastModifiedBy

任务最后修改用户

类型integer

格式"int64"

lastModifiedDate

任务最后修改日期

类型string

格式"date-time"

admin

当应用管理员查询所有项目时必填

类型boolean

hasPermission

当用户查询具有单一权限项目时必填

类型string

有效值

"MODIFY_SPRINT""DELETE_SPRINT""ADD_TASK""MODIFY_TASK""DELETE_TASK""EXPORT_TASK""RESTART_TASK""REOPEN_TASK""GRANT"

favouriteBy

类型integer

格式"int64"

followBy

类型integer

格式"int64"

commentBy

类型integer

格式"int64"

pageNo

页面数据大小，默认为1，最大值为100000

类型integer

格式"int32"

最大值100000

最小值1

pageSize

页面数据大小，默认为10，最大值为2000

类型integer

格式"int32"

最大值2000

最小值1

orderBy

排序字段

类型string

orderSort

排序方式

类型string

有效值

"ASC""DESC"

filters[0].key

筛选字段名称

类型string

filters[0].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[0].value

筛选值

类型object

filters[1].key

筛选字段名称

类型string

filters[1].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[1].value

筛选值

类型object

filters[2].key

筛选字段名称

类型string

filters[2].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[2].value

筛选值

类型object

infoScope

查询信息范围

类型string

有效值

"BASIC""DETAIL"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/task/search

试验场

授权

UserHttpBearer

变量

键

值

projectId*

id

name

code

softwareVersion

sprintId

moduleId

backlog

targetId

targetParentId

taskType

bugLevel

testType

assigneeId

confirmorId

testerId

missingBug

unplanned

parentTaskId

tagId

priority

evalWorkload

actualWorkload

status

overdue

failNum

totalNum

execId

execBy

execResult

startDate

deadlineDate

confirmedDate

completedDate

processedDate

canceledDate

execDate

createdBy

createdDate

lastModifiedBy

lastModifiedDate

admin

hasPermission

favouriteBy

followBy

commentBy

pageNo

pageSize

orderBy

orderSort

filters[0].key

filters[0].op

filters[0].value

filters[1].key

filters[1].op

filters[1].value

filters[2].key

filters[2].op

filters[2].value

infoScope

示例

cURL

JavaScript

PHP

Python

---

将任务标记为已处理

PUT

/api/v1/task/{id}/processed

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/processed

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

将任务的任务关联起来

PUT

/api/v1/task/{id}/association/task

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

assocTaskIds*

类型array

必填

最大项数200

最小项数0

唯一项true

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/association/task

试验场

授权

UserHttpBearer

变量

键

值

id*

assocTaskIds*

示例

cURL

JavaScript

PHP

Python

---

导入任务

POST

/api/v1/task/import

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

请求体

multipart/form-data

响应

成功

Content-Type

*/*

"string"

POST

/api/v1/task/import

试验场

授权

UserHttpBearer

主体

示例

cURL

JavaScript

PHP

Python

---

将任务移至另一个迭代

PATCH

/api/v1/task/move

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PATCH

/api/v1/task/move

试验场

授权

UserHttpBearer

主体

示例

cURL

JavaScript

PHP

Python

---

查询任务列表

GET

/api/v1/task

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

projectId*

项目ID

类型integer

必填

格式"int64"

id

任务ID

类型integer

格式"int64"

name

任务名称

类型string

code

任务代码

类型string

softwareVersion

任务软件的版本

类型string

sprintId

任务迭代ID

类型integer

格式"int64"

moduleId

任务模块ID

类型integer

格式"int64"

backlog

积压工作标志。true：冲刺积压工作，false：产品积压工作

类型boolean

targetId

与该任务关联的场景或API ID

类型integer

格式"int64"

targetParentId

与该任务关联的场景目录或服务ID

类型integer

格式"int64"

taskType

任务类型

类型string

有效值

"REQUIREMENT""STORY""TASK""BUG""API_TEST""SCENARIO_TEST"

bugLevel

缺陷等级

类型string

有效值

"CRITICAL""MAJOR""MINOR""TRIVIAL"

testType

任务测试类型

类型string

有效值

"PERFORMANCE""FUNCTIONAL""STABILITY""CUSTOMIZATION"

assigneeId

经办人ID

类型integer

格式"int64"

confirmorId

确认者ID

类型integer

格式"int64"

testerId

测试者ID

类型integer

格式"int64"

missingBug

缺失的错误标志

类型boolean

unplanned

类型boolean

parentTaskId

任务父级ID

类型integer

格式"int64"

tagId

标签ID

类型integer

格式"int64"

priority

任务优先级

类型string

有效值

"HIGHEST""HIGH""MEDIUM""LOW""LOWEST"

evalWorkload

任务评估工作量

类型number

actualWorkload

任务实际工作量

类型number

status

任务状态

类型string

有效值

"PENDING""IN_PROGRESS""CONFIRMING""COMPLETED""CANCELED"

overdue

任务是否逾期

类型boolean

failNum

任务失败数量

类型integer

格式"int32"

totalNum

已处理的任务数量

类型integer

格式"int32"

execId

执行ID

类型integer

格式"int64"

execBy

执行用户ID

类型integer

格式"int64"

execResult

任务执行结果

类型string

有效值

"SUCCESS""FAIL"

startDate

任务开始日期

类型string

格式"date-time"

deadlineDate

任务截止日期

类型string

格式"date-time"

confirmedDate

任务确认日期

类型string

格式"date-time"

completedDate

任务完成日期

类型string

格式"date-time"

processedDate

任务处理日期

类型string

格式"date-time"

canceledDate

任务取消日期

类型string

格式"date-time"

execDate

任务执行日期

类型string

格式"date-time"

createdBy

任务创建者

类型integer

格式"int64"

createdDate

任务创建日期

类型string

格式"date-time"

lastModifiedBy

任务最后修改用户

类型integer

格式"int64"

lastModifiedDate

任务最后修改日期

类型string

格式"date-time"

admin

当应用管理员查询所有项目时必填

类型boolean

hasPermission

当用户查询具有单一权限项目时必填

类型string

有效值

"MODIFY_SPRINT""DELETE_SPRINT""ADD_TASK""MODIFY_TASK""DELETE_TASK""EXPORT_TASK""RESTART_TASK""REOPEN_TASK""GRANT"

favouriteBy

类型integer

格式"int64"

followBy

类型integer

格式"int64"

commentBy

类型integer

格式"int64"

pageNo

页面数据大小，默认为1，最大值为100000

类型integer

格式"int32"

最大值100000

最小值1

pageSize

页面数据大小，默认为10，最大值为2000

类型integer

格式"int32"

最大值2000

最小值1

orderBy

排序字段

类型string

orderSort

排序方式

类型string

有效值

"ASC""DESC"

filters[0].key

筛选字段名称

类型string

filters[0].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[0].value

筛选值

类型object

filters[1].key

筛选字段名称

类型string

filters[1].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[1].value

筛选值

类型object

filters[2].key

筛选字段名称

类型string

filters[2].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[2].value

筛选值

类型object

infoScope

查询信息范围

类型string

有效值

"BASIC""DETAIL"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/task

试验场

授权

UserHttpBearer

变量

键

值

projectId*

id

name

code

softwareVersion

sprintId

moduleId

backlog

targetId

targetParentId

taskType

bugLevel

testType

assigneeId

confirmorId

testerId

missingBug

unplanned

parentTaskId

tagId

priority

evalWorkload

actualWorkload

status

overdue

failNum

totalNum

execId

execBy

execResult

startDate

deadlineDate

confirmedDate

completedDate

processedDate

canceledDate

execDate

createdBy

createdDate

lastModifiedBy

lastModifiedDate

admin

hasPermission

favouriteBy

followBy

commentBy

pageNo

pageSize

orderBy

orderSort

filters[0].key

filters[0].op

filters[0].value

filters[1].key

filters[1].op

filters[1].value

filters[2].key

filters[2].op

filters[2].value

infoScope

示例

cURL

JavaScript

PHP

Python

---

创建任务

POST

/api/v1/task

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

POST

/api/v1/task

试验场

授权

UserHttpBearer

主体

示例

cURL

JavaScript

PHP

Python

---

删除任务

DELETE

/api/v1/task

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

ids*

任务ID

类型array

必填

最大项数200

最小项数0

唯一项true

响应

成功

Content-Type

*/*

"string"

DELETE

/api/v1/task

试验场

授权

UserHttpBearer

变量

键

值

ids*

示例

cURL

JavaScript

PHP

Python

---

查询任务未关联的案例列表

GET

/api/v1/task/{id}/case/notAssociated

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

moduleId

模块ID

类型integer

格式"int64"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/task/{id}/case/notAssociated

试验场

授权

UserHttpBearer

变量

键

值

id*

moduleId

示例

cURL

JavaScript

PHP

Python

---

重启任务

PATCH

/api/v1/task/{id}/restart

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

PATCH

/api/v1/task/{id}/restart

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

修改任务中的子任务

PUT

/api/v1/task/{id}/subtask/set

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

subTaskIds*

类型array

必填

最大项数200

最小项数0

唯一项true

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/subtask/set

试验场

授权

UserHttpBearer

变量

键

值

id*

subTaskIds*

示例

cURL

JavaScript

PHP

Python

---

替换任务的描述

PUT

/api/v1/task/{id}/description

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/description

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

关联任务案例

PUT

/api/v1/task/{id}/association/case

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

assocCaseIds*

类型array

必填

最大项数200

最小项数0

唯一项true

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/association/case

试验场

授权

UserHttpBearer

变量

键

值

id*

assocCaseIds*

示例

cURL

JavaScript

PHP

Python

---

取消任务的关联案例

PUT

/api/v1/task/{id}/association/case/cancel

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

assocCaseIds*

类型array

必填

最大项数200

最小项数0

唯一项true

响应

取消成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/association/case/cancel

试验场

授权

UserHttpBearer

变量

键

值

id*

assocCaseIds*

示例

cURL

JavaScript

PHP

Python

---

替换任务的标签

PUT

/api/v1/task/{id}/tag

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/tag

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

重新开启任务

PATCH

/api/v1/task/{id}/reopen

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

PATCH

/api/v1/task/{id}/reopen

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

查询任务未关联的子任务列表

GET

/api/v1/task/{id}/subtask/notAssociated

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

moduleId

模块ID

类型integer

格式"int64"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/task/{id}/subtask/notAssociated

试验场

授权

UserHttpBearer

变量

键

值

id*

moduleId

示例

cURL

JavaScript

PHP

Python

---

完成任务

PUT

/api/v1/task/{id}/complete

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

evalWorkload

任务评估工作量

类型number

最大值10000

最小值0

actualWorkload

任务实际工作量

类型number

最大值10000

最小值0

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/complete

试验场

授权

UserHttpBearer

变量

键

值

id*

evalWorkload

actualWorkload

示例

cURL

JavaScript

PHP

Python

---

替换任务的优先级

PUT

/api/v1/task/{id}/priority/{priority}

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

priority*

任务优先级

类型string

必填

有效值

"HIGHEST""HIGH""MEDIUM""LOW""LOWEST"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/priority/{priority}

试验场

授权

UserHttpBearer

变量

键

值

id*

priority*

示例

cURL

JavaScript

PHP

Python

---

查询任务详情

GET

/api/v1/task/{id}

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/task/{id}

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

替换任务

PUT

/api/v1/task/{id}

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

更新任务

PATCH

/api/v1/task/{id}

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PATCH

/api/v1/task/{id}

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

导入任务示例

POST

/api/v1/task/example/import

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

projectId*

项目ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

POST

/api/v1/task/example/import

试验场

授权

UserHttpBearer

变量

键

值

projectId*

示例

cURL

JavaScript

PHP

Python

---

替换任务的截止日期

PUT

/api/v1/task/{id}/deadline/{deadline}

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

deadline*

任务截止日期

类型string

必填

格式"date-time"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/deadline/{deadline}

试验场

授权

UserHttpBearer

变量

键

值

id*

deadline*

示例

cURL

JavaScript

PHP

Python

---

替换任务的实际工作量

PUT

/api/v1/task/{id}/actualWorkload

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/actualWorkload

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

按条件导出任务

GET

/api/v1/task/export

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

projectId*

项目ID

类型integer

必填

格式"int64"

id

任务ID

类型integer

格式"int64"

name

任务名称

类型string

code

任务代码

类型string

softwareVersion

任务软件的版本

类型string

sprintId

任务迭代ID

类型integer

格式"int64"

moduleId

任务模块ID

类型integer

格式"int64"

backlog

积压工作标志。true：冲刺积压工作，false：产品积压工作

类型boolean

targetId

与该任务关联的场景或API ID

类型integer

格式"int64"

targetParentId

与该任务关联的场景目录或服务ID

类型integer

格式"int64"

taskType

任务类型

类型string

有效值

"REQUIREMENT""STORY""TASK""BUG""API_TEST""SCENARIO_TEST"

bugLevel

缺陷等级

类型string

有效值

"CRITICAL""MAJOR""MINOR""TRIVIAL"

testType

任务测试类型

类型string

有效值

"PERFORMANCE""FUNCTIONAL""STABILITY""CUSTOMIZATION"

assigneeId

经办人ID

类型integer

格式"int64"

confirmorId

确认者ID

类型integer

格式"int64"

testerId

测试者ID

类型integer

格式"int64"

missingBug

缺失的错误标志

类型boolean

unplanned

类型boolean

parentTaskId

任务父级ID

类型integer

格式"int64"

tagId

标签ID

类型integer

格式"int64"

priority

任务优先级

类型string

有效值

"HIGHEST""HIGH""MEDIUM""LOW""LOWEST"

evalWorkload

任务评估工作量

类型number

actualWorkload

任务实际工作量

类型number

status

任务状态

类型string

有效值

"PENDING""IN_PROGRESS""CONFIRMING""COMPLETED""CANCELED"

overdue

任务是否逾期

类型boolean

failNum

任务失败数量

类型integer

格式"int32"

totalNum

已处理的任务数量

类型integer

格式"int32"

execId

执行ID

类型integer

格式"int64"

execBy

执行用户ID

类型integer

格式"int64"

execResult

任务执行结果

类型string

有效值

"SUCCESS""FAIL"

startDate

任务开始日期

类型string

格式"date-time"

deadlineDate

任务截止日期

类型string

格式"date-time"

confirmedDate

任务确认日期

类型string

格式"date-time"

completedDate

任务完成日期

类型string

格式"date-time"

processedDate

任务处理日期

类型string

格式"date-time"

canceledDate

任务取消日期

类型string

格式"date-time"

execDate

任务执行日期

类型string

格式"date-time"

createdBy

任务创建者

类型integer

格式"int64"

createdDate

任务创建日期

类型string

格式"date-time"

lastModifiedBy

任务最后修改用户

类型integer

格式"int64"

lastModifiedDate

任务最后修改日期

类型string

格式"date-time"

admin

当应用管理员查询所有项目时必填

类型boolean

hasPermission

当用户查询具有单一权限项目时必填

类型string

有效值

"MODIFY_SPRINT""DELETE_SPRINT""ADD_TASK""MODIFY_TASK""DELETE_TASK""EXPORT_TASK""RESTART_TASK""REOPEN_TASK""GRANT"

favouriteBy

类型integer

格式"int64"

followBy

类型integer

格式"int64"

commentBy

类型integer

格式"int64"

pageNo

页面数据大小，默认为1，最大值为100000

类型integer

格式"int32"

最大值100000

最小值1

pageSize

页面数据大小，默认为10，最大值为2000

类型integer

格式"int32"

最大值2000

最小值1

orderBy

排序字段

类型string

orderSort

排序方式

类型string

有效值

"ASC""DESC"

filters[0].key

筛选字段名称

类型string

filters[0].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[0].value

筛选值

类型object

filters[1].key

筛选字段名称

类型string

filters[1].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[1].value

筛选值

类型object

filters[2].key

筛选字段名称

类型string

filters[2].op

过滤条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[2].value

筛选值

类型object

infoScope

查询信息范围

类型string

有效值

"BASIC""DETAIL"

响应

成功

Content-Type

*/*

GET

/api/v1/task/export

试验场

授权

UserHttpBearer

变量

键

值

projectId*

id

name

code

softwareVersion

sprintId

moduleId

backlog

targetId

targetParentId

taskType

bugLevel

testType

assigneeId

confirmorId

testerId

missingBug

unplanned

parentTaskId

tagId

priority

evalWorkload

actualWorkload

status

overdue

failNum

totalNum

execId

execBy

execResult

startDate

deadlineDate

confirmedDate

completedDate

processedDate

canceledDate

execDate

createdBy

createdDate

lastModifiedBy

lastModifiedDate

admin

hasPermission

favouriteBy

followBy

commentBy

pageNo

pageSize

orderBy

orderSort

filters[0].key

filters[0].op

filters[0].value

filters[1].key

filters[1].op

filters[1].value

filters[2].key

filters[2].op

filters[2].value

infoScope

示例

cURL

JavaScript

PHP

Python

---

取消任务的所有子任务

PUT

/api/v1/task/{id}/subtask/cancel

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

subTaskIds*

类型array

必填

最大项数200

最小项数0

唯一项true

响应

取消成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/subtask/cancel

试验场

授权

UserHttpBearer

变量

键

值

id*

subTaskIds*

示例

cURL

JavaScript

PHP

Python

---

替换任务的缺陷等级

PUT

/api/v1/task/{id}/missingBug

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

missingBug*

缺失的错误标志

类型boolean

必填

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/missingBug

试验场

授权

UserHttpBearer

变量

键

值

id*

missingBug*

示例

cURL

JavaScript

PHP

Python

---

取消任务的关联任务

PUT

/api/v1/task/{id}/association/task/cancel

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

assocTaskIds*

类型array

必填

最大项数200

最小项数0

唯一项true

响应

取消成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/association/task/cancel

试验场

授权

UserHttpBearer

变量

键

值

id*

assocTaskIds*

示例

cURL

JavaScript

PHP

Python

---

替换任务的确认人

PUT

/api/v1/task/{id}/confirmor

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

请求体

application/json

"string"

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/confirmor

试验场

授权

UserHttpBearer

变量

键

值

id*

主体

示例

cURL

JavaScript

PHP

Python

---

替换任务类型

PUT

/api/v1/task/{id}/type

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

查询参数

type*

任务类型

类型string

必填

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/type

试验场

授权

UserHttpBearer

变量

键

值

id*

type*

示例

cURL

JavaScript

PHP

Python

---

确认任务的处理结果

PUT

/api/v1/task/{id}/result/{result}/confirm

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

任务ID

类型integer

必填

格式"int64"

result*

任务处理结果

类型string

必填

有效值

"SUCCESS""FAIL"

查询参数

evalWorkload

任务评估工作量

类型number

最大值10000

最小值0

actualWorkload

任务实际工作量

类型number

最大值10000

最小值0

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/task/{id}/result/{result}/confirm

试验场

授权

UserHttpBearer

变量

键

值

id*

result*

evalWorkload

actualWorkload

示例

cURL

JavaScript

PHP

Python

---