結合・APIテストを実行する
最終更新日: 2026年11月6日
API 定義を用意して実行し、応答とケースごとの期待結果を確認します。
対象製品：Acsim Test
初期設定を入力し、設計書とテストケースを取り込んでから進めます。作業者の PC の環境チェックで、使うツールを確認してください。
用意するもの
| 項目 | 確認内容 |
|---|---|
| テスト対象 | API の URL、認証、必要なテストデータ |
| 設計書 | API 仕様、項目、ステータス、エラー応答 |
| ソースコード | API を実装しているフォルダ |
| API 定義 | OpenAPI・Swagger・Pact など。ソースと設計書から生成する方法もある |
| ケース | 呼び出す API、入力条件、期待する応答が分かる記述 |
1. 結合・API を選ぶ
- 「テストケース」から対象の仕様書を開きます。
- 「テストの方法を選ぶ」の「編集」で「結合・API」を選び、「登録」を押します。
- 「テストデータ」で必要なデータを用意し、値と投入方法を確認します。
2. API 定義を用意する
- 「テストコードを作る」を開きます。
- 「API 定義の用意のしかた」で、次のいずれかを選びます。
- 生成・取り込みを終えたら、定義とソースコードの違いや確認できなかった項目を読みます。
- テスト計画に入らなかったケースがあれば、ケースに呼び出しが書かれているか、定義に対象の API があるかを確認します。
| 選び方 | 操作 |
|---|---|
| ソースと設計書から作る | 選択したうえで「テストコードを作る」を押す |
| API 定義をアップロード | 選択して手元の API 定義ファイルを指定し、変換・確認結果を読む |
形式を選ぶのではなく、使う定義ファイルを指定します。変換後の差異も確認します。
OpenAPI・Swagger・Pact は読み込みに対応しています。Markdown・CSV・Excel・Word・Postman・HAR などは AI による変換の対象です。API 定義のアップロードでは PDF・PowerPoint はまだ読めません。
「実際に呼んで確かめる」を選ぶと、生成時に対象の GET を呼び、応答の形を定義と比べます。これは対象への通信を伴うので、URL を確認してから選んでください。
3. 実行する
- 実行対象のケースを確認し、「テストを実行する」を開きます。
- 「テスト実行」を押し、完了を待ちます。
- ケースの状況と、使われた API 定義・実行結果を確認します。
- 失敗した行を開き、期待するステータスや項目と、実際の応答を比べます。
困ったとき
| 状況 | 確認すること |
|---|---|
| API 定義が用意できない | ソースと設計書の不足、AI の利用設定、アップロード形式 |
| 定義とソースが食い違う | どちらが今回の正しい仕様かを開発担当者と確認 |
| 認証・接続で失敗 | URL、アカウント、対象の起動状態、接続できるネットワーク |
| ケースが計画に入らない | ケースの呼び出し記述と、API 定義の対象範囲 |
失敗したケースは テスト不具合を Issue 化する 手順へ進みます。修正後は同じケースを再テストし、第 2 回・第 3 回の変化を ダッシュボード で確認します。
準備済みのサンプルの実行画面です。対象のケースを確認し、テスト実行へ進みます。