テスト スイートに関する情報を取得したり、テスト スイート作成または変更するには、次の 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 |
レスポンスの内容
成功した場合、このメソッドは 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 のみ – リクエストが多すぎます |