ステップ1
テストケースを記述する
CSVやJSONファイル、またはデータセットビューに1行につき1つのテストケースを記述します。各列はリクエストやスクリプトが読み取る変数になります。
APIが動くようになったら、次はあらゆるエッジケースをテストしましょう。
Postmanのデータ駆動テストでは、CSVやJSONファイル、またはデータベースのテストデータの行ごとにコレクションを1回ずつ実行するため、開発者、QAチーム、コーディングエージェントは失敗の原因となった正確な入力を特定できます。
PostmanアプリのCollection Runnerで実行するほか、Claude Code、Codex、Cursorなどの好みのコーディングエージェントにPostman CLIを使って実行させることもできます。
世界中の導入企業
Postmanプラグインをインストールすると、エージェントがデータ駆動テストのワークフローを自律的に実行できるようになります。エッジケースをまとめたCSVやJSONファイルの作成、行ごとのコレクションの実行、ファイルやデータベースに対するSQLビューを用いたデータセットの構築、そして失敗した行に基づくCIの制御まで一貫して行えます。
すべてのコマンドは、CIパイプラインで使用しているものと同じツールであるPostman CLIを通じて実行されます。
マーケットプレイス
Postmanプラグインを入手
claude plugin marketplace add anthropics/claude-plugins-officialclaude plugin install postman@claude-plugins-officialQuery files and databases with SQL, then run a collection once per row
Run a collection over every row of a CSV or JSON file
Gate every PR on your Postman tests
Keep secrets in the Shared Vault, out of committed files
次のプロンプトを試してみてください
Postmanが選ばれる理由
テストケースごとに新しいテストコードを書く必要はありません。CSVファイル、JSONファイル、またはデータセットにケースをまとめておけば、既存のコレクションを行ごとに1回ずつ実行できます。
テストケースをCSVまたはJSONファイルにまとめ、-dオプションで実行時に渡します。各列は{{tier}}のようにリクエストやスクリプトが読み取る変数になるため、ケースを追加する際は行を追加するだけで対応できます。
コレクションは各行に対して1回ずつ実行されます。テストが失敗すると、実行結果にイテレーション名が表示されるため、エージェントはどの行を確認すべきか把握できます。サインインした状態でクラウド上またはリンクされたコレクションを実行すると、各テストの結果とエラーの詳細がPostmanにアップロードされます。
データセットを使用すると、CSV、JSON、スプレッドシートファイルや、MySQL、Postgres、SQL Server、JDBCデータベースをSQLでクエリできるテーブルに変換できます。ビューによって特定のシナリオに必要な行を抽出し、ファイルとライブデータベースを結合することも可能です。
各データセットは、データ行自体をコピーすることなく、データの保存場所と各ビューのSQLを記録した.dataset.yamlファイルです。変更内容は他のコードと同様にレビューを通すことができます。
ビューをイテレーションデータとして使用したり、Postman CLIでの実行を含むプレリクエストおよびポストレスポンススクリプトでpm.datasetsを使ってデータセットにクエリを実行したり、ローカルモックからデータ行を返したりできます。
データベースの認証情報は、データセットファイルに平文で記載する代わりに、Shared Vaultの参照やCIの環境変数を使用できます。接続には、読み取り専用アクセスに制限されたデータベースアカウントを使用してください。
ステップ1
CSVやJSONファイル、またはデータセットビューに1行につき1つのテストケースを記述します。各列はリクエストやスクリプトが読み取る変数になります。
ステップ2
Collection RunnerまたはPostman CLIでコレクションを実行します。各行が1つのイテレーションとして実行されます。
ステップ3
失敗したテストには該当するイテレーション名が表示されるため、どの行を確認すべきかすぐに把握できます。
ステップ4
パイプラインで同じコマンドを実行し、いずれかの行が失敗した際にビルドを失敗させます。
データ駆動APIテストとは、テストデータの各行に対して同じリクエストとテストを1回ずつ実行し、1つのコレクションで多様な入力パターンを網羅するテスト手法です。Postmanでは各行が1つのイテレーションとして扱われ、列の値がリクエストやスクリプトから読み取れる変数になります。新しいテストケースを追加する際は、行を追加するだけで対応できます。
はい、実行できます。npm install -g postman-cliでPostman CLIをインストールし、postman initを実行してリポジトリにPostmanのエージェントスキルを導入してください。これにより、Claude Code、Codex、CursorなどのエージェントがテストケースをまとめたCSVやJSONファイルを作成して-dオプション付きでpostman collection runを実行したり、データセットを構築して--iteration-data-datasetと--iteration-data-viewを指定し、そのビューの1つに対してテストを実行したりできるようになります。
データファイルは、1回の実行で使用する固定値のセットを記述したCSVまたはJSONファイルです。一方、データセットは一度定義すると、コレクションの実行、パフォーマンステスト、モニター、モック、スクリプトで再利用できます。ファイルとライブデータベースを組み合わせることができ、SQLビューを使ってシナリオごとに必要な行を抽出できます。また、データファイルのサイズは5MB未満である必要がありますが、データセットにはファイルサイズの制限がありません。シンプルなテストケースのリストにはデータファイルを使用し、データのフィルタリングや結合、再利用が必要な場合にはデータセットを使用してください。詳しくはDatasetsのドキュメントをご覧ください。
データベースをソースとしてデータセットに追加し、必要な行を選択するビューを保存して、そのビューに対してコレクションを実行します。Postman CLIでは、postman dataset source addでMySQL、Postgres、SQL Server、またはJDBCドライバーを備えたデータベースに接続し、postman dataset view createでSQLを保存し、--iteration-data-datasetと--iteration-data-viewを指定してpostman collection runを実行することで、行ごとに1つのイテレーションを実行できます。PostmanのWebアプリではMySQLおよびPostgresソースを追加できますが、ローカルファイル、SQL Server、JDBCソースにはデスクトップアプリまたはPostman CLIが必要です。ライブデータベースソースの利用にはTeamまたはEnterpriseプランが必要であり、カスタムJDBCソースにはEnterpriseプランが必要です。
イテレーション番号を確認してください。各行は1つのイテレーションとして実行され、Postman CLIの失敗サマリーには失敗したすべてのテストのイテレーションが表示されます。CLIにサインインしており、コレクションがPostman内にあるかPostmanにリンクされている場合、各テストの結果とエラーの詳細が実行結果ページにアップロードされます。
リテラル値の代わりに、Shared Vaultの参照または環境変数を使用してください。Postman CLIでは、データベースのホスト、ユーザー、またはパスワードにvault:<KEY> を指定でき、env:<NAME> を使用するとCIでPOSTMAN_VAULT_<NAME> 環境変数を読み取ります。リテラルパスワードはデータセットファイルに平文で保存されるため、読み取り専用アクセスに制限されたデータベースアカウントで接続してください。
はい。パフォーマンステストでは、同じCSVやJSONデータファイル、またはデータセットビューを読み取り、各行を仮想ユーザーに分散できます。Postman CLIでは、postman performance runに--data-file、または--dataset-idと--dataset-view-idを指定し、--dataset-distributionで行を仮想ユーザーに割り当てる方法(デフォルトのround-robin、fixed、またはrandom)を設定します。詳しくはパフォーマンステストをご覧ください。
データファイルとDatasetsは、Postman Solo、Team、Enterpriseの各プランで利用できます。ライブデータベースソースへの接続にはTeamまたはEnterpriseプランが必要であり、カスタムJDBCソースにはEnterpriseプランが必要です。各プランに含まれる機能の詳細については、料金プランをご覧ください。