ページを選択

テスト スイート

テスト スイートに関する情報を取得したり、テスト スイート作成または変更するには、次の API メソッドを使用します。

get_suite

既存のテスト スイートを返します。

GET index.php?/api/v2/get_suite/{suite_id}

パラメーター

名前 タイプ 必須 説明
suite_id integer true テスト スイートの ID

レスポンスの内容

典型的なレスポンスについては、下記を参照してください。

{
    "description": "..",
    "id": 1,
    "name": "Setup & Installation",
    "project_id": 1,
    "url": "http:///testrail/index.php?/suites/view/1"
}

レスポンスには次のフィールドが含まれています。

名前 タイプ 説明
completed_on timestamp テスト スイートがクローズされた日時 (UNIXタイムスタンプ) (TestRail 4.0 で追加)
description string テスト スイートの説明
id integer テスト スイートの一意の ID
is_baseline boolean テスト スイートがベースライン テスト スイートである場合は true、そうでない場合は false (TestRail 4.0で追加)
is_completed boolean テスト スイートが完了/アーカイブ済みとしてマークされている場合は true、そうでない場合は false (TestRail 4.0で追加)
is_master boolean テスト スイートがマスター テスト スイートである場合は true、そうでない場合は false (TestRail 4.0で追加)
name string テスト スイートの名前
project_id integer テスト スイートが所属するプロジェクトの ID
url string ユーザー インターフェイスに表示されるテスト スイートのアドレス/URL

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートがレスポンスの一部として返されます
400 無効または不明なテスト スイート
403 プロジェクトにアクセスできない
429 TestRail Cloud のみ – リクエストが多すぎます

get_suites

プロジェクトのテスト スイートのリストを返します。

GET index.php?/api/v2/get_suites/{project_id}

パラメーター

名前 タイプ 必須 説明
project_id integer true プロジェクトの ID

レスポンスの内容

レスポンスにはテスト スイートの配列が含まれます。リスト内の各プロジェクトの形式は、get_suite と同じです。

[
    {
        "id": 1,
        "name": "Setup & Installation", 
    },
    {
        "id": 2,
        "name": "Document Editing", 
    },
]

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートがレスポンスの一部として返されます
400 無効または不明なプロジェクト
403 プロジェクトにアクセスできない
429 TestRail Cloud のみ – リクエストが多すぎます

add_suite

新規テスト スイートを作成します。

POST index.php?/api/v2/add_suite/{project_id}

パラメーター

名前 タイプ 必須 説明
project_id integer true テスト スイートを追加するプロジェクトの ID

リクエスト ボディ

POST リクエスト ボディでは以下のフィールドがサポートされています。

名前 タイプ 必須 説明
name string true テスト スイートの名前
description string false テスト スイートの説明

リクエストの例

新しい空のテスト スイートを作成する方法を示す次の例も参照してください。

{
    "name": "This is a new test suite",
    "description": "Use the description to add additional context details"
}

テスト スイートを追加したら、セクションおよびテスト ケースを追加できます。

レスポンスの内容

成功した場合、このメソッドは get_suite と同じレスポンス形式を使用して新しいテスト スイートを返します。

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートが作成され、レスポンスの一部として返されます
400 無効または不明なプロジェクト
403 テスト スイートを追加する権限がない、またはプロジェクトへのアクセス権がない
429 TestRail Cloud のみ – リクエストが多すぎます

update_suite

既存のテスト スイートを更新します (部分的な更新がサポートされています。つまり、特定のフィールドのみを送信して更新できます)。

POST index.php?/api/v2/update_suite/{suite_id}

パラメーター

名前 タイプ 必須 説明
suite_id integer true テスト スイートの ID
このメソッドは add_suite と同じ POST フィールドをサポートします。

レスポンスの内容

成功した場合、このメソッドは get_suite と同じレスポンス形式を使用して更新されたテスト スイートを返します。

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートが更新され、レスポンスの一部として返されます
400 無効または不明なテスト スイート
403 テスト スイートを更新する権限がない、またはプロジェクトへのアクセス権がない
429 TestRail Cloud のみ – リクエストが多すぎます

delete_suite

削除したテスト スイートを元に戻すことはできず、すべてのアクティブなテスト ランおよびテスト結果、つまりまだクローズされていない (アーカイブされていない) テスト ランおよびテスト結果も削除されます。

既存のテスト スイートを削除します。


POST index.php?/api/v2/delete_suite/{suite_id}

パラメーター

名前 タイプ 必須 説明
suite_id integer true テスト スイートの ID

Soft パラメーター

soft パラメーターを省略した場合、または soft=0 をサブミットした場合、テスト スイートとそのテスト ケースは削除されます。

If soft=1 の場合、影響を受けるテスト、テスト ケースなどの数に関するデータを返します。

soft=1 の場合、エンティティは実際には削除されません。

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートとそのすべてのテストケースが削除されました
400 無効または不明なテスト スイート
403 テスト スイートを削除する権限がない、またはプロジェクトへのアクセス権がない
429 TestRail Cloud のみ – リクエストが多すぎます