Testcase

获取测试用例详情分享链接/book/api/get-testcases-caseid-2206.html

作者：禅道团队最后编辑：于 2026-01-12 16:42:02 浏览量：97

摘要：获取测试用例详情

本篇目录

GET

/testcases/:caseID

获取测试用例详情

请求URL

https://xxx.com/api.php/v2/testcases/:caseID

请求头

名称	类型	必填	描述
token	string	是	访问凭证Token

请求响应

名称	类型	描述
status	string	状态(success 成功 \| fail 失败)
testcase	object	用例
∟ id	string	用例编号
∟ project	int	所属项目
∟ product	string	所属产品
∟ execution	int	所属执行
∟ branch	string	平台/分支
∟ lib	string	所属库
∟ module	string	所属模块
∟ path	string	路径
∟ story	string	相关用户故事
∟ storyVersion	string	用户故事版本
∟ title	string	用例名称
∟ precondition	string	前置条件
∟ keywords	string	关键词
∟ pri	string	优先级
∟ type	string	用例类型
∟ auto	string	自动化测试用例
∟ frame	string	自动化测试框架
∟ stage	string	适用阶段
∟ howRun	string	测试方式
∟ script	string	自动化脚本
∟ scriptedBy	string	脚本由谁创建
∟ scriptedDate	string	脚本创建日期
∟ scriptStatus	string	脚本状态
∟ scriptLocation	string	脚本地址
∟ status	string	用例状态
∟ subStatus	string	子状态
∟ color	string	标题颜色
∟ frequency	string	使用频率
∟ order	string	排序
∟ openedBy	string	由谁创建
∟ openedDate	string	创建日期
∟ reviewedBy	string	由谁评审
∟ reviewedDate	string	评审时间
∟ lastEditedBy	string	最后修改者
∟ lastEditedDate	string	修改日期
∟ version	string	用例版本
∟ linkCase	string	相关用例
∟ fromBug	string	来源Bug
∟ fromCaseID	string	用例来源ID
∟ fromCaseVersion	string	用例来源版本
∟ lastRunner	string	执行人
∟ lastRunDate	string	执行时间
∟ lastRunResult	string	结果
∟ scene	string	所属场景
∟ sort	string
∟ deleted	string	已删除
∟ toBugs	array
∟ fromBugData	array
∟ linkCaseTitles	array
∟ currentVersion	string
∟ files	array	附件
∟ steps	array	用例步骤
∟ caseID	string
∟ needconfirm	boolean
∟ caseFails	string
∟ mindMapSteps	array

响应示例

{
    "status": "success",
    "testcase": {
        "id": "1",
        "project": 2,
        "product": "1",
        "execution": 3,
        "branch": "0",
        "lib": "0",
        "module": "0",
        "path": "0",
        "story": "0",
        "storyVersion": "1",
        "title": "测试光敏模块显示是否正常",
        "precondition": "",
        "keywords": "",
        "pri": "3",
        "type": "feature",
        "auto": "no",
        "frame": "",
        "stage": ",",
        "howRun": "",
        "script": "",
        "scriptedBy": "",
        "scriptedDate": "",
        "scriptStatus": "",
        "scriptLocation": "",
        "status": "normal",
        "subStatus": "",
        "color": "",
        "frequency": "1",
        "order": "0",
        "openedBy": "admin",
        "openedDate": "2026-01-12 16:40:27",
        "reviewedBy": "",
        "reviewedDate": "",
        "lastEditedBy": "admin",
        "lastEditedDate": "2026-01-12 16:40:28",
        "version": "2",
        "linkCase": "",
        "fromBug": "0",
        "fromCaseID": "0",
        "fromCaseVersion": "1",
        "lastRunner": "",
        "lastRunDate": "",
        "lastRunResult": "",
        "scene": "0",
        "sort": "0",
        "deleted": "0",
        "toBugs": [],
        "fromBugData": [],
        "linkCaseTitles": [],
        "currentVersion": "2",
        "files": [],
        "steps": [
            {
                "name": "1",
                "id": "3",
                "step": "步骤1",
                "desc": "步骤1",
                "expect": "期望1",
                "type": "step",
                "parent": "0",
                "grade": 1
            },
            {
                "name": "2",
                "id": "4",
                "step": "步骤2",
                "desc": "步骤2",
                "expect": "期望2",
                "type": "step",
                "parent": "0",
                "grade": 1
            }
        ],
        "caseID": "1",
        "needconfirm": false,
        "caseFails": "0",
        "mindMapSteps": {
            "id": "case_1",
            "text": "测试光敏模块显示是否正常",
            "type": "root",
            "children": [
                {
                    "id": "3",
                    "text": "步骤1",
                    "type": "sub",
                    "parent": "case_1",
                    "subSide": "right",
                    "children": [
                        {
                            "id": "desc_3",
                            "text": "期望1",
                            "type": "node",
                            "parent": "3",
                            "subSide": "right"
                        }
                    ]
                },
                {
                    "id": "4",
                    "text": "步骤2",
                    "type": "sub",
                    "parent": "case_1",
                    "subSide": "right",
                    "children": [
                        {
                            "id": "desc_4",
                            "text": "期望2",
                            "type": "node",
                            "parent": "4",
                            "subSide": "right"
                        }
                    ]
                }
            ]
        }
    }
}