データ駆動型テスト

APIが動くようになったら、次はあらゆるエッジケースをテストしましょう。

Postmanのデータ駆動テストでは、CSVやJSONファイル、またはデータベースのテストデータの行ごとにコレクションを1回ずつ実行するため、開発者、QAチーム、コーディングエージェントは失敗の原因となった正確な入力を特定できます。

PostmanアプリのCollection Runnerで実行するほか、Claude Code、Codex、Cursorなどの好みのコーディングエージェントにPostman CLIを使って実行させることもできます。

始める

エージェント向けにインストール

npm install -g postman-cli
Get started with
説明用の数値を使った、ターミナル上のClaude Codeの実行例です。サンプル数値を用いた実行例:ターミナル内のClaude Codeの画面。プルリクエストの前にすべての顧客タイプに対して割引変更をテストするよう指示されると、顧客タイプごとに1行ずつ記述したCSVファイルを作成し、Postman CLIで行ごとにCheckoutコレクションを1回ずつ実行する。5つのイテレーションのうち4つがパスする。クーポンを使用した従業員の行であるイテレーション4は、合計金額が80.00ではなく90.00になるため失敗する。エージェントは新しいコードが社員割引の代わりにクーポンを適用してしまっていることを突き止めて修正し、コレクションを再実行して5つのイテレーション全体で全15個のテストにパスさせ、レビュアー向けにPostmanの実行結果へのリンクを提示する。

世界中の導入企業

PayPal社のロゴ
Moneris社のロゴ
Autodesk社のロゴ
TotalEnergies社のロゴ
Cover Genius社のロゴ
Siemens社のロゴ
ZEISS社のロゴ

コーディングエージェントにPostmanプラグインをインストール

Postmanプラグインをインストールすると、エージェントがデータ駆動テストのワークフローを自律的に実行できるようになります。エッジケースをまとめたCSVやJSONファイルの作成、行ごとのコレクションの実行、ファイルやデータベースに対するSQLビューを用いたデータセットの構築、そして失敗した行に基づくCIの制御まで一貫して行えます。

すべてのコマンドは、CIパイプラインで使用しているものと同じツールであるPostman CLIを通じて実行されます。

Postmanプラグインを入手

ステップ 1
claude plugin marketplace add anthropics/claude-plugins-official
ステップ 2
claude plugin install postman@claude-plugins-official
Postmanのすべてのスキルを見る

次のプロンプトを試してみてください

Postmanが選ばれる理由

Postmanのデータ駆動テスト

テストケースごとに新しいテストコードを書く必要はありません。CSVファイル、JSONファイル、またはデータセットにケースをまとめておけば、既存のコレクションを行ごとに1回ずつ実行できます。

  • テストコードとテストデータを分離

    テストケースをCSVまたはJSONファイルにまとめ、-dオプションで実行時に渡します。各列は{{tier}}のようにリクエストやスクリプトが読み取る変数になるため、ケースを追加する際は行を追加するだけで対応できます。

  • 行ごとに1イテレーションを実行

    コレクションは各行に対して1回ずつ実行されます。テストが失敗すると、実行結果にイテレーション名が表示されるため、エージェントはどの行を確認すべきか把握できます。サインインした状態でクラウド上またはリンクされたコレクションを実行すると、各テストの結果とエラーの詳細がPostmanにアップロードされます。

  • ファイルとデータベースを横断するSQLビュー

    データセットを使用すると、CSV、JSON、スプレッドシートファイルや、MySQL、Postgres、SQL Server、JDBCデータベースをSQLでクエリできるテーブルに変換できます。ビューによって特定のシナリオに必要な行を抽出し、ファイルとライブデータベースを結合することも可能です。

  • Gitで管理できるデータセットファイル

    各データセットは、データ行自体をコピーすることなく、データの保存場所と各ビューのSQLを記録した.dataset.yamlファイルです。変更内容は他のコードと同様にレビューを通すことができます。

  • 実行、スクリプト、モックで同じデータを活用

    ビューをイテレーションデータとして使用したり、Postman CLIでの実行を含むプレリクエストおよびポストレスポンススクリプトでpm.datasetsを使ってデータセットにクエリを実行したり、ローカルモックからデータ行を返したりできます。

  • データセットファイルから機密情報を除外

    データベースの認証情報は、データセットファイルに平文で記載する代わりに、Shared Vaultの参照やCIの環境変数を使用できます。接続には、読み取り専用アクセスに制限されたデータベースアカウントを使用してください。

サンプルデータを用いたアニメーション例:Checkout test dataという名前のPostmanデータセットで、one_row_per_tierビューを開いている画面。データテーブルには各ティア(guest、member、gold、employee、tax_exempt)につき1人ずつ、計5人の顧客とその国およびクーポンコードが一覧表示されている。テーブルの下には、customersテーブルとcouponsテーブルを結合してティアごとに1行を返すビューのSQLクエリが表示されている。

仕組み

ステップ1

テストケースを記述する

CSVやJSONファイル、またはデータセットビューに1行につき1つのテストケースを記述します。各列はリクエストやスクリプトが読み取る変数になります。

ステップ2

行ごとに1回実行する

Collection RunnerまたはPostman CLIでコレクションを実行します。各行が1つのイテレーションとして実行されます。

ステップ3

失敗した行を特定する

失敗したテストには該当するイテレーション名が表示されるため、どの行を確認すべきかすぐに把握できます。

ステップ4

CIの品質ゲートに組み込む

パイプラインで同じコマンドを実行し、いずれかの行が失敗した際にビルドを失敗させます。

よくある質問

5,000万人以上の開発者と50万社以上の企業が利用しています。

エージェント向けにインストール

npm install -g postman-cli
Get started with

デスクトップ向けにインストール

無料で登録