开放平台文档

# 说明

获取计划关联的bug列表

# url

https://api.tapd.cn/api/testx/plan/v1/namespaces/{namespace}/plans/{plan_uid}/bugs

# 支持格式

JSON

# 调用方式

参考 授权-用户态

# HTTP请求方式

GET

# 请求参数

# Request

字段名 必选 类型及范围 说明
PlanUid 是 string 计划ID
Namespace 是 string 命名空间
PageInfo 是 PageInfo 分页信息
RelatedTypes 是 repeated string 筛选来源
Status 是 Status 筛选状态
Summary 否 string 缺陷标题
BugId 否 string 缺陷ID

# pageinfo

字段名 必选 类型及范围 说明
Offset 是 uint32 分页偏移位置
Limit 是 uint32 每页数量

# 返回结果

{
    "Error": null,
    "Data": [
        {
            "WorkspaceId": "workspace_uid",
            "IterationId": "0",
            "Id": "bugid",
            "Summary": "test",
            "Creator": "xxx",
            "Priority": {
                "Label": "",
                "Value": ""
            },
            "Created": "2024-03-29 14:40:00",
            "Status": {
                "Label": "新",
                "Value": "NEW"
            },
            "LastUpdater": "rokieguo",
            "UpdateTime": "2024-03-29 14:40:00",
            "Severity": {
                "Label": "",
                "Value": "SEVERITY_INIT"
            },
            "Owners": "",
            "Begin": "",
            "Due": "",
            "NamespaceId": "",
            "Description": "<p>【问题描述】</p><p><br  /></p><p><br  /></p><p><br  /></p><p>【截图】</p><p><br  /></p><p><br  /></p><p><br  /></p><p>【链接地址】</p><p><br  /></p><p><br  /></p><p><br  /></p>",
            "Url": "",
            "Developers": "",
            "Testers": "",
            "Module": "",
            "Attachments": [],
            "Tags": [],
            "RelatedType": "PLAN",
            "IconType": "",
            "Version": [],
            "ReleaseId": "0",
            "VersionReport": "",
            "VersionTest": "",
            "VersionFix": "",
            "VersionClose": "",
            "BaselineFind": "",
            "BaselineJoin": "",
            "BaselineClose": "",
            "BaselineTest": "",
            "CC": "",
            "Participator": "",
            "Auditer": "",
            "Confirmer": "",
            "Fixer": "",
            "Closer": "",
            "ReopenTime": "",
            "InProgressTime": "",
            "Resolved": "",
            "VerifyTime": "",
            "Closed": "",
            "RejectTime": "",
            "Modified": "2024-03-29 14:40:00",
            "Deadline": "",
            "Os": "",
            "Platform": "",
            "Testmode": "",
            "Testphase": "",
            "Testtype": "",
            "Source": "",
            "Frequency": "",
            "Originphase": "",
            "Sourcephase": "",
            "Resolution": {
                "Label": "",
                "Value": "RESOLUTION_INIT"
            },
            "Estimate": "",
            "Lastmodify": "",
            "CustomFields": {},
            "TemplateId": "",
            "IsApplyTemplateDefaultValue": false,
            "CustomPlanFields": {},
            "Feature": "",
            "Effort": "",
            "Bugtype": "",
            "Size": ""
        }
    ],
    "TotalCount": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

# bug字段说明

# Bug

字段名 类型及范围 说明
WorkspaceId string 工作空间ID
IterationId string 迭代ID
Id string 缺陷ID
Summary string 标题
Creator string 创建人
Priority BugPriority 优先级
Created string 创建时间
Status BugStatus 状态
LastUpdater string 最后更新人
UpdateTime string 更新时间
Severity BugSeverity 严重程度
Owners string 处理人
Begin string 预计开始时间
Due string 结束时间
NamespaceId string 命名空间ID
Description string 描述
Url string URL
Developers string 开发人员
Testers string 测试人员
Module string 模块
Attachments repeated Attachment 附件列表
Tags repeated string 标签
RelatedType string 关联类型
IconType string 图标类型
Version repeated string 版本
ReleaseId string 发布计划ID
VersionReport string 发现版本
VersionTest string 验证版本
VersionFix string 合入版本
VersionClose string 关闭版本
BaselineFind string 发现基线
BaselineJoin string 合入基线
BaselineClose string 关闭基线
BaselineTest string 验证基线
CC string 抄送人
Participator string 参与人
Auditer string 审核人
Confirmer string 验证人
Fixer string 修复人
Closer string 关闭人
ReopenTime string 重新打开时间
InProgressTime 是 string
Resolved string 解决时间
VerifyTime string 验证时间
Closed string 关闭时间
RejectTime string 拒绝时间
Modified string 最后修改时间
Deadline string 解决期限
Os string 操作系统
Platform string 软件平台
Testmode string 测试方式
Testphase string 测试阶段
Testtype string 测试类型
Source string 缺陷根源
Frequency string 重现规律
Originphase string 发现阶段
Sourcephase string 引入阶段
Resolution BugResolution 解决方法
Estimate string 预计工时
Lastmodify string 最后修改人
CustomFields map<string, string> 自定义字段
TemplateId string 模板ID
IsApplyTemplateDefaultValue 是 bool
CustomPlanFields map<string, string> 自定义计划字段
Feature string 特性
Effort string 预计工时
Bugtype string 缺陷类型
Size string 规模

# BugStatus

字段名 类型及范围 说明
Label string 状态标签
Value State 状态值

# BugPriority

字段名 类型及范围 说明
Label string 优先级标签
Value string 优先级值

# BugSeverity

字段名 类型及范围 说明
Label string 严重程度标签
Value Severity 严重程度值

# BugResolution

字段名 类型及范围 说明
Label string 解决方法标签
Value Resolution 解决方法值

# Status

枚举值 说明
STATUS_ALL 全部状态
NEW 新
POSTPONED 延期
REJECTED 已拒绝
REOPENED 重新打开
RESOLVED 已解决
SUSPENDED 挂起
UNCONFIRMED 待确认
VERIFIED 已验证
IN_PROGRESS 接受/处理中
ASSIGNED 已分配
CLOSED 已关闭

# Severity

值 说明
SEVERITY_ALL 所有严重程度
FATAL 致命
NORMAL 一般
PROMPT 提示
SERIOUS 严重
ADVICE 建议
SEVERITY_INIT 未设置

# Resolution

值 说明
RESOLUTION_ALL 所有解决方法
IGNORE 无需解决
FIXED 已修改
FIX_LATER 延期解决
FAILED_TO_RECUR 无法重现
EXTERNAL_REASON 外部原因
DUPLICATED 重复
INTENTIONAL_DESIGN 设计如此
UNCLEAR_DESCRIPTION 问题描述不准确
FEATURE_CHANGE 需求变更
TRANSFERRED_TO_STORY 已转需求
HOLD 挂起
RESOLUTION_INIT 未设置

# Attachment

字段名 类型及范围 说明
Id string 附件ID
DownloadUrl string 下载URL
Type string 类型
EntryId string 条目ID
Filename string 文件名
Description string 描述
ContentType string 内容类型
Created string 创建时间
WorkspaceId string 工作空间ID
Owner string 所有者
上次更新: 2025-07-30 16:12:58

← 获取计划关联缺陷数 →