Apidog バージョン 2.7.29 以降、エンドポイント詳細ページでテストケースを直接追加できるようになりました。各テストケースは、そのエンドポイントに対するリクエストパラメータのセットを表します。ユーザーはすべてのテストケースを体系的に整理・管理し、ワンクリックで実行して現在のエンドポイントのテストを完了できます。目的: さまざまなリクエストシナリオにおいてエンドポイントが期待どおりに動作するかを検証することです。網羅性を重視します。
幅広いシナリオをカバー: 正常系、異常系、境界値、セキュリティなどです。
通常、変更または実行される頻度は比較的低くなります。
目的: 開発中またはトラブルシューティング中にエンドポイントのレスポンスを素早く検証することです。速度を重視します。
一般的に、成功や失敗などの基本的なシナリオに限定されます。
テストケースの作成#
1. 手動作成#
エンドポイント詳細ページの Test Cases タブで + Add Case をクリックすると、手動で作成できます。2. デバッグケースからインポート#
テストケースを追加する際に、Import from Debug Cases を選択して、既存のデバッグケースをテストケースにコピーまたは移動できます。コピー: 迅速な検証のためにデバッグケースを引き続き必要とする一方で、テストケースとしても使用したい場合に使用します。
移動: デバッグケースがデバッグで頻繁に使用されなくなり、主に例外テスト用に作成されていた場合に使用します。これにより、デバッグケースを直接テストケースに変換できます。テストケースがもともとデバッグケースとして作成されていた場合、移行をより迅速に行えます。
テストケースの詳細#
グループ: テスト目的（正常系、異常系、境界値など）ごとに整理されます。
リクエストパラメータ: Path、Query、Header、および form-data Body パラメータです。
リクエストボディ: RAW、JSON、XML などをサポートします。
レスポンス検証: 検証の有効化/無効化、および検証対象のレ スポンスコンポーネントを指定します。
[!NOTE]
テストケースは更新頻度が低いため、エンドポイントの変更と手動で同期する必要があります。たとえば、エンドポイントに新しいフィールドが追加された場合、テストケース内の Update をクリックして更新する必要があります。
テストケース詳細への編集内容は、Save をクリックして保存する必要があります。未保存の変更がある場合、システムが通知します。テストケースの管理#
Test Cases タブでは、作成済みのすべてのテストケースを管理できます。左上隅の検索機能とフィルター機能を使用すると、必要なテストケースを簡単に見つけられます。また、グループタブを使用して、グループ別にテストケースをすばやく表示することもできます。特定のテストケースに対する操作は次のとおりです。単一のテストケース: 新しいタブを開いて、テストケースの表示、変更、実行を行えます。基本操作には、コピー、テストケースの他グループへの移動、テストケースの cURL のコピー、テス トケースの削除が含まれます。
複数のテストケース: リストで複数のテストケースを選択すると、右上隅にアクションボタンが表示され、一括グループ化、削除、エンドポイント更新との同期を実行できます。
テストケースの実行#
テストケースを表示しているときに Run ボタンをクリックすると、そのパラメータを使用してリクエストを送信できます。その後、実際のレスポンスが表示されます。Run All を使用することも、リストから複数のテストケースを選択してまとめて実行することもできます。インターフェースには、現在実行中のケースと結果があるケースが表示されます。一括実行後、テストケースを開くと、その実行結果を直接確認できます。テストレポート#
テストを一括実行した後、右上の Test Reports ですべての履歴レポートを確認できます。レポートをクリックすると詳細な結果を表示でき、問題の追跡と分析に役立ちます。単一エンドポイントテストのベストプラクティス#
単一エンドポイントのテストには、通常、バックエンド開発者と QA エンジニアという 2 つの役割が関わります。バックエンド開発者: エンドポイントコードの作成とデバッグを行います。
QA エンジニア: 包括的な API テストを実施し、問題を特定します。
QA エンジニアは、エンドポイントドキュメント内で単体テストケースを直接作成・管理できます。
開発者は、既存のテストケースを使用してテストを実行し、結果を確認して、自分で問題を修正できます。QA エンジニアからのフィードバックや長いやり取りを待つ必要はありません。
1.
エンドポイントドキュメントが確定した直後にテストケースを作成でき、Apidog 内ですべてのチームメンバーが確認できます。
2.
開発者はデバッグ後、自分でエンドポイントをテストできます。QA エンジニアを待つ必要はありません。
3.
開発者はテスト結果に基づいて直接問題を修正できます。追加のチケットや引き継ぎは不要です。
4.
明確なテスト結果により、問題の説明が簡潔になり、誤解を避けられます。
Modified at 2026-06-11 07:06:02
