モック
1つのAPIの代わりに応答する
モックは、APIの動作を再現するJavaScriptコードです。リクエスト間で状態を保持し、エラーや応答の遅延、レート制限も再現できます。
Postman Mock Serversを使うと、リクエスト間で状態を保持するモックをコードで作成し、チームのドメイン上にデプロイできます。モックを更新してもURLは変わりません。他のチームやCI、コーディングエージェントは、このURLを使って、APIの完成を待たずにビルドやテストを進められます。
世界中の導入企業
Postmanプラグインをインストールすると、コーディングエージェントがAPIの仕様、コレクション、コードをもとにモックを作成できます。作成したモックをチームが利用できるURLにデプロイするまで、一連の作業を自律的に実行します。
マーケットプレイス
Postmanプラグインを入手
claude plugin marketplace add anthropics/claude-plugins-officialclaude plugin install postman@claude-plugins-official1つのAPIを再現し、状態を保持するモックを探す・作成する・公開する
サービスが呼び出すAPIを探し、担当チームが公開するモックを再利用する
モックや実際のAPIに対してアサーションを実行する
次のプロンプトを試してみてください
Postmanが選ばれる理由
APIが未完成だったり、他のチームが管理していたり、共有ステージング環境でしか使えなかったりすると、開発やテストに待ち時間が生じます。Postmanのモックサーバーなら、必要なときに利用できるモックを固定URLで用意できます。応答や動作を自分たちで制御できるため、想定した条件で開発やテストを進められます。
バックエンドの開発中でも、フロントエンド、モバイル、サービスの各チームは、リクエスト間で状態を保持するモックを使って実装やテストを進められます。
チームのドメイン上のURLにモックをデプロイできます。モックを更新しても、URLは変わりません。
CIジョブ、開発者、エージェントは、それぞれ専用のセッションでモックを利用できます。並行して実行しても、互いのデータに影響を与えずに作業を進められます。
モックで応答の遅延、エラー、レート制限を再現し、リクエストの再試行、代替処理への切り替え、復旧までの動作を確認できます。
決済、本人確認、パートナーのAPIの代わりにモックを使って、連携をテストできます。実際のAPIの利用枠を消費せず、実データの作成や外部システムへの影響も発生しません。
モックへの呼び出しをリクエストログで確認できます。パス、HTTPメソッド、ステータスコードで絞り込み、失敗したリクエストを特定できます。
既存のコレクション、OpenAPI仕様、データセットをもとに、リクエスト間で状態を保持するモックを作成できます。足りない部分は、コーディングエージェントがプロジェクトのコードをもとに補えます。
次のステップ
モック
モックは、APIの動作を再現するJavaScriptコードです。リクエスト間で状態を保持し、エラーや応答の遅延、レート制限も再現できます。
シミュレート
サービスが依存するAPIのモックを、1つの.sim.yamlファイルでまとめて実行します。各モックには、共通のアドレスからアクセスできます。
デプロイ
チームのドメイン上にデプロイすると、他の開発者、CI、エージェントも同じシミュレーションを利用できます。それぞれの環境で個別に実行する必要はありません。
Postman Simulatorなら、依存先のサービスをすべて起動せずに、実際に近いAPIの動作を再現できます。その環境でアプリケーションを動かし、開発とテストをより速く進められます。
モックサーバーによって、開発時の依存関係が解消されました。Postmanでは、APIの開発・テスト・リリースを並列で実行できます。APIの実装完了を待つ必要はありません。”
Eduardo Iriarte-Mendez氏
シニアソフトウェアエンジニア, Flix
Postmanのモックサーバーは、チームのドメイン上の固定URL(https://payments.mock.acme.postman.dev)にデプロイされたモックです。他のチーム、CI、コーディングエージェントから呼び出せます。
モックは、1つのAPIの代わりに応答するJavaScriptコードです。リポジトリ内で管理でき、リクエスト間で状態を保持します。応答の遅延やレート制限、障害なども再現できます。アクセスできる相手を制御でき、状態は呼び出し元のセッションごとに独立して保持されます。
複数のモックをまとめて実行するには、シミュレーションを使います。詳しくは「Postman Simulator」をご覧ください。モックサーバーはHTTP APIに対応しています。
postman mock pushでモックをプッシュし、postman mock deployでスラッグを指定してデプロイします。アプリから操作する場合は、[+]>[Mock Server]>[Existing mock]を選択します。CLIでモックをデプロイすると、サンプルリクエストが出力されます。
モックはすべてのプランで利用できます。デプロイにはSolo、Team、Enterpriseのいずれかのプランが必要です。詳しくは「料金プラン」をご覧ください。Learning Centerでは、JavaScriptでモックを作成する方法とモックサーバーをデプロイする方法とモックサーバーをデプロイする方法を説明しています。初めて利用する方には、ブログ記事Introducing Code-Based Mocks in Postmanのチュートリアルも役立ちます。
ローカルやCIでは、コマンドを実行した環境でモックが動作します。デプロイしたモックサーバーはPostman上で稼働し、アクセスできる相手は自分たちで制御できます。サインイン済みのPostmanアプリやCLIから呼び出すことができ、その他のクライアントからは、x-api-keyヘッダーにPostman APIキーを指定して呼び出します。モックサーバーを公開し、URLを知っている人なら誰でも呼び出せるようにすることもできます。詳しくは「Postmanのセキュリティ」をご覧ください。
呼び出し元ごとにx-mock-sessionヘッダーを設定するか、Postmanが自動的に設定するpm_mock_session Cookieを使用すると、それぞれの状態が独立して保持されます。セッションはデフォルトで有効です。全員が同じデータを見る必要がある共有デモなどでは、セッションを無効にすることもできます。
いいえ。モックを更新しても、URL(https://payments.mock.acme.postman.dev)は変わりません。再デプロイしてもスラッグは維持されます。自動デプロイを有効にすると、クラウド上のモックへの変更が、デプロイ済みのサーバーに自動的に反映されます。
コレクションベースのモックサーバーは、Postmanのコレクションに保存されたサンプルを返す仕組みで、ドキュメントや簡単なデモに適しています。Postmanのモックは、状態の保持やシナリオの切り替えができるコードで、ローカル、CI、またはデプロイしたモックサーバー上で実行できます。既存のコレクションベースのモックサーバーは引き続き利用でき、同じコレクションからコードベースのモックを生成することもできます。
Postmanのモックは、リポジトリ内で管理するJavaScriptファイルです。状態を保持し、名前付きのシナリオを切り替えられます。APIの担当チームが1つのモックを公開し、すべてのAPI利用者が再利用します。安定しているサービスには引き続きステージング環境を使い、不安定なサービス、まだ存在しないサービス、他のチームが管理するサービスは、シミュレーションで再現できます。
他のモックツールから移行する場合、静的なルートとサンプルはOpenAPI仕様を通じて引き継げます。状態を保持する動作は、エージェントがコードとして書き直せます。利用する前に、移行結果を確認してください。
いいえ、必須ではありません。開発者は、PostmanアプリやPostman CLIでモックやシミュレーションを作成、編集、実行できます。コーディングエージェントも同じファイルとコマンドを使うため、エージェントなしで使い始め、後から追加できます。Claude Code、OpenAI Codex、Cursor、Gemini CLI、Factory、OpenCodeは、Postmanプラグインとスキルを通じて利用できます。
依存先のAPIを待つことで、開発やテストが滞っていませんか?Postmanの担当者が課題を伺い、ローカル開発、CI、共有テスト環境でモックを共通の方法で運用するための進め方をご紹介します。こちらのフォームより、お気軽にご相談ください。営業へのお問い合わせも受け付けています。