全部產品
Search
文件中心

Alibaba Cloud DevOps:ListTestPlan - 擷取測試計劃列表

更新時間:Jul 07, 2026

服務存取點與授權資訊

產品

資源

要求的權限

測試管理

測試計劃

唯讀

請求文法

Region版

POST https://{domain}/oapi/v1/projex/testPlan/list

要求標頭

參數

類型

是否必填

描述

樣本值

x-yunxiao-token

string

個人存取權杖。

pt-0fh3****0fbG_35af****0484

請求參數

參數

類型

位置

是否必填

描述

樣本值

page

integer

query

分頁參數,第幾頁,預設為1。

perPage

integer

query

分頁參數,每頁大小,最大1000,預設為1000。

sprintIdentifier

string

query

迭代 identifier,傳入則只返回該迭代下的測試計劃。

projectIdentifier

string

query

專案 identifier;與 sprintIdentifier 同時傳入時用於校正迭代是否屬於該專案;僅傳此項則按專案篩選測試計劃。

status

string

query

測試計劃狀態,可選值 TODO,DOING,DONE。可多選,以逗號分割。

DOING,DONE

name

string

query

測試計劃名稱(模糊條件)。

請求樣本

Region版

curl -X 'POST' \
  'https://{domain}/oapi/v1/projex/testPlan/list?page={page}&perPage={perPage}&sprintIdentifier={sprintIdentifier}&projectIdentifier={projectIdentifier}&status={status}&name={name}' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

返回參數

參數

類型

描述

樣本值

-

array

-

object

gmtCreate

string

建立時間的時間戳記。

managers

array[string]

測試計劃管理員 id。

spaceIdentifier

string

關聯專案 id。

testPlanIdentifier

string

測試計劃 id。

返回樣本

[
    {
        "gmtCreate": "",
        "managers": [
        ],
        "name": "",
        "spaceIdentifier": "",
        "testPlanIdentifier": ""
    }
]

回應標頭

參數

描述

樣本值

x-next-page

下一頁。

x-page

當前頁。

x-per-page

每頁資料條數。

x-prev-page

上一頁。

x-total

總資料量。

x-total-pages

總分頁數。

錯誤碼

訪問錯誤碼中心查看 API 相關錯誤碼。