ヘッドレスAPIモックツールは、仕様や設定からAPIの動作する偽物を起動し、クリック操作を必要としないコマンドラインから実行します。これはCIパイプライン、Dockerコンテナ、またはフロントエンド開発スクリプト内でまさに必要なものです。このガイドでは、モックにおける「ヘッドレス」の意味を説明し、実際のヘッドレスオプション（Prism、WireMock、Mockoon CLI）を紹介し、Apidogがどのように適合するかを解説します。最初にコンセプトを知りたい場合は、モックAPIとは何かから始めてください。
APIモックにおける「ヘッドレス」とは
モックサーバーは、偽物だがリアルなレスポンスでHTTPリクエストに応答するため、実際のバックエンドが存在する前にフロントエンドやテストスイートを実行できます。「ヘッドレス」とは、モックがグラフィカルインターフェースなしで実行されることを意味します。コマンドで起動し、仕様ファイルやデータファイルを指定すると、特定のポートでリッスンします。
これが重要である理由は、モックが最も必要とされる場所は、画面がない場所だからです。
- 安定したバックエンドに対してテストを実行する必要があるCIジョブ。
docker-composeスタック内のDockerコンテナ。- バックグラウンドでモックを実行したいチームメイトのターミナル。
- プルリクエストごとに一時的に起動されるプレビュー環境。
GUIモックツールは、ラップトップでレスポンスを設計するには問題ありません。しかし、パイプラインでそのモックが必要になった瞬間、ヘッドレスモードが必要です。CLIフラグ、Dockerイメージ、またはどのジョブからもアクセスできるホスト型URLなどです。
仕様駆動型と設定駆動型モック
ヘッドレスモックツールは2つのタイプに分かれ、その違いがワークフロー全体を形成します。
仕様駆動型ツールは、OpenAPIドキュメントを読み込み、そこから直接レスポンスを提供します。スキーマが唯一の真実の源です。仕様にフィールドを追加すると、モックがそれを返します。これにより、モックは契約から大きく逸脱することなく、整合性を保ちます。
設定駆動型ツールは、独自の形式（JSONファイル、記録されたスタブ、手書きのルール）でレスポンスを保存します。これらは柔軟で、仕様がカバーしないエッジケースに適していますが、設定は手動で維持する必要があり、実際のAPIからずれてしまう可能性があります。
ほとんどのチームは、ハッピーパスには仕様駆動型を、特殊なケースには設定駆動型の上書きを望んでいます。最高のAPIモック設定は両方をサポートしています。
ヘッドレスモックの選択肢（正直なところ）
知っておくべきツールをいくつか紹介します。それぞれGUIなしで動作し、固有の強みを持っています。
Prism (Stoplight)
Prismは、OpenAPI 2/3またはPostman Collectionファイルを1つのコマンドでモックサーバーに変換します。
prism mock openapi.yaml
デフォルトではhttp://127.0.0.1:4010でリッスンします。デフォルトでは、仕様書から静的なexamplesを返します。-d（動的）を追加すると、Prismはスキーマからランダムだが有効なデータを生成し、x-faker拡張機能を通じてFakerをサポートします。オープンソースで軽量、そして真に仕様ファーストです。契約が単一のOpenAPIファイルにあり、純粋なCLIモックを望むなら、Prismは強力な選択肢です。
WireMock
WireMockは成熟したJavaベースのHTTPモックサーバーです。スタンドアロンのjarファイルを実行します。
java -jar wiremock-standalone-3.x.x.jar --port 9099
その核となるモデルはスタビングです。JSON APIまたはJSONファイルを通じて、リクエストマッチングルールとそれが返すレスポンスを定義します。また、実際のサービスからのトラフィックを記録および再生する機能も備えており、仕様がないものの動作するバックエンドからキャプチャしたい場合に便利です。WireMockは、複雑なリクエストマッチング、ステートフルなシナリオ、およびJVMを多用するスタックでその真価を発揮します。
Mockoon CLI
Mockoonはデスクトップアプリですが、ヘッドレス利用のためのCLIも付属しています。CLIは、サーバー上、CI上、またはデスクトップアプリを開けない場所で、構築したモック環境を実行します。
mockoon-cli start --data ./environment.json --port 3000
公式のDockerイメージと、自己完結型のモックイメージを生成するdockerizeコマンドを提供しています。Mockoonは設定駆動型（GUIで環境を構築し、ヘッドレスで実行）で、テンプレート、レスポンスルール、プロキシモードを備えています。視覚的に設計し、ヘッドレスでデプロイしたい場合に最適です。
Apidogモックサーバー
ApidogはオールインワンのAPIプラットフォームであり、そのモックサーバーはデフォルトでスキーマ駆動型です。APIを定義またはインポートすると、Apidogは追加設定なしでモックを生成します。そのSmart Mockはフィールド名と型を読み取り、現実的なデータを生成します。email、avatar、username、phone、date、IPなどの項目を認識し、stringプレースホルダーの代わりに適切な値で埋めます。完全に制御するには、{{$person.fullName}}や{{$number.int(min=1,max=100)}}のようなFaker.js式、および特定の要求条件に対するカスタムモックルールを使用できます。
ヘッドレス利用の場合、ApidogはCloud Mock URL（https://mock.apidog.com/...）を公開しており、CIジョブやチームメイトはローカルで何も実行することなくアクセスできます。ローカルモックも127.0.0.1で実行され、イントラネットIPにバインドすることで他のマシンからアクセスすることも可能です。モックはAPIデザイン、ドキュメント、テストを保持する同じプロジェクトから派生しているため、個別の設定ファイルにずれることなく、契約と整合性が保たれます。
比較
| ツール | 真実の源 | ヘッドレス実行 | リアルなデータ | 最適な用途 |
|---|---|---|---|---|
| Prism | OpenAPI / Postmanファイル | prism mock spec.yaml |
ダイナミックモード (-d) + x-faker |
純粋な仕様ファーストのCLIモック |
| WireMock | スタブルール / 記録 | スタンドアロンjar | レスポンステンプレーティング | 複雑なマッチング、JVMスタック、記録/再生 |
| Mockoon CLI | GUIで構築された環境 | mockoon-cli start + Docker |
テンプレーティングヘルパー | ビジュアルデザイン、ヘッドレスデプロイ |
| Apidog | プロジェクト内のAPIスキーマ | クラウドモックURL + ローカルサーバー | Smart Mock + Faker.js | デザイン、ドキュメント、テストに連携したスキーマ駆動型モック |
唯一の勝者というものはありません。API全体が1つのOpenAPIファイルにまとまっているならPrismが最もクリーンです。リクエストマッチングの深さではWireMockが優れています。視覚的に構築したいならMockoonが良いでしょう。Apidogは、モック、契約、ドキュメント、テストをすべて一箇所にまとめ、それらがばらばらにならないようにしたいチームに適しています。より広い範囲を知りたい場合は、最高のAPIモックツールのまとめをご覧ください。
CIでヘッドレスモックを実行する
ツールを問わず、パターンは同じです。モックを起動し、テストをモックに向け、そしてモックをシャットダウンします。
パイプラインステップでの仕様ファーストCLIモックは次のようになります。
# start the mock in the background
prism mock ./openapi.yaml &
MOCK_PID=$!
# run your frontend or API tests against http://127.0.0.1:4010
npm test
# clean up
kill $MOCK_PID
Apidogを使用すると、テストをCloud Mock URLに向けるだけで何も実行せずに済ませるか、同じ方法でローカルモックを実行することもできます。モックは現在のスキーマから応答するため、契約が変更されるとモックもそれに合わせて変更されます。
自然な次のステップは、そのモックに対してコマンドラインからテストを実行することです。ApidogのCLI（apidog-cli）自体もヘッドレスです。apidog runはCIでテストシナリオを実行し、CSVまたはJSONからのデータ駆動型実行をサポートし、CLI、HTML、またはJSONレポートを生成します。コマンドラインからREST APIをテストするのウォークスルーでは完全なループが示されており、完全なCLIガイドではフラグについて説明されています。Newmanを使用したことがある場合は、Apidog CLIとPostman CLIの比較で概念を対比して理解できます。
モックとAIコーディングエージェント
Cursor、Claude、VS Codeなどでコードを書く場合、エージェントはモックの背後にあるAPI契約を知ることで恩恵を受けます。Apidog MCPサーバーを使用すると、AIエージェントがAPI仕様を直接読み取れるため、モックが既に提供しているスキーマに一致するクライアントコードをスキャフォールディングできます。これにより、エージェントの出力とモックのレスポンスが同じ契約を指し示すように保たれます。
よくある質問
ヘッドレスモックはモックサーバーと同じですか？
はい、ただし1つの詳細が異なります。モックサーバーは、偽のレスポンスでリクエストに応答するあらゆるプロセスです。「ヘッドレス」は、GUIなしで動作し、コマンドまたはURLでホストされて起動することを指定します。そのため、CI、Docker、スクリプトで機能します。ここで紹介するすべてのツールはヘッドレスで実行できます。
OpenAPI仕様からヘッドレスモックを生成できますか？
はい。PrismはOpenAPIを直接読み取り、Apidogはプロジェクト内のスキーマからモックを生成します。仕様駆動型モックは、個別に管理される設定ではなく、仕様が示す内容をモックが反映するため、手間を省き、契約との整合性を保ちます。完全なワークフローについては、APIモックガイドをご覧ください。
ヘッドレスモックはプレースホルダーではなく、どのようにリアルなデータを返しますか？
各ツールにはデータエンジンがあります。Prismのダイナミックモードとx-fakerはスキーマから値を生成します。ApidogのSmart Mockは、emailやphoneのようなフィールド名を適切な値に一致させ、より細かい制御のためにFaker.js式を組み込むことができます。これらがなければ、モックは空の文字列やゼロを返す傾向があります。
サーバーを実行する必要がありますか、それともホストされたモックURLを使用できますか？
どちらも機能します。WireMock、Prism、Mockoon CLIは、ユーザーが管理するプロセスを実行します。Apidogは、CIジョブやチームメイトがローカルでの設定なしに呼び出せるホスト型Cloud Mock URLを追加し、パイプラインから1つの可動部品を削減します。
結論
ヘッドレスAPIモックツールは、ローカルでクリック操作をサポートするモックと、実際にパイプラインで実行されるモックとの違いを明確にします。Prism、WireMock、Mockoon CLIはそれぞれ、彼らの作業スタイルに適した方法でこれをうまく行います。モックが、独自の設定で乖離することなく、APIデザイン、ドキュメント、テストに密接に結びついていることを望むなら、Apidogはこれらすべてを1つのプロジェクトにまとめ、ローカルまたはホストされたURLから実行できるスキーマ駆動型モックを提供します。Apidogをダウンロードして、仕様からモックを起動し、CIで活用してください。