高度な機能
リクエスト条件マッチング
URL パターンに加えて、リクエストの詳細な条件でマッチングできます。

条件タイプ
| タイプ | 説明 | 例 |
|---|---|---|
| クエリパラメータ | URL のクエリパラメータでマッチング | page=1 |
| ヘッダー | リクエストヘッダーでマッチング | Authorization: Bearer * |
| ボディ | リクエストボディの内容でマッチング | {"type": "premium"} |
演算子
equals完全一致
contains部分一致
startsWith前方一致
endsWith後方一致
regex正規表現マッチ
existsキーの存在チェック
論理演算子
複数の条件を組み合わせることができます。
ANDすべての条件を満たす
ORいずれかの条件を満たす
設定例
「プレミアムユーザーの検索リクエスト」のみをマッチングする場合:
URL Pattern: /api/search*
Method: GET
Conditions (AND):
- Query Parameter "q" exists
- Header "X-User-Type" equals "premium"パススルー
モックルールがマッチしても、実サーバーへリクエストを転送する機能です。
リクエストパススルー
リクエストをそのまま実サーバーに転送します。レスポンスはモックルールで設定した内容を返します。
ユースケース: リクエストをサーバーに送信しつつ、レスポンスを固定したい場合(例:A/B テストで特定のレスポンスを常に返す)
レスポンスパススルー
実サーバーからのレスポンスをそのまま返します。モックルールは条件マッチングのみに使用します。
ユースケース: 特定の条件でログを取りたいが、レスポンスは変更したくない場合
ヒント: リクエストパススルーとレスポンスパススルー を同時に有効にすると、ルールは条件マッチングとログ記録のみに使用されます。
レスポンス修正
実サーバーからのレスポンスを部分的に修正できます。
ステータスコード上書き
レスポンスパススルーを有効にした状態でステータスコード を指定すると、実サーバーのステータスコードを上書きできます。
# 実サーバーが 200 を返しても、500 に変更
レスポンスパススルー: ON
ステータスコード: 500エラー処理のテストに便利です。
レスポンスボディマージ
JSON レスポンスの場合、実サーバーのレスポンスとモックのレスポンスをマージできます。
# 実サーバーのレスポンス
{
"id": 1,
"name": "John",
"status": "active"
}
# モックで設定したボディ(Merge Response Body: ON)
{
"status": "inactive",
"debug": true
}
# 最終レスポンス
{
"id": 1,
"name": "John",
"status": "inactive",
"debug": true
}ネットワーク遅延シミュレーション
レスポンスの遅延をシミュレートして、ネットワーク環境のテストができます。
遅延設定
各ルールの遅延 (ミリ秒) フィールドにミリ秒単位で遅延時間を設定します。
0遅延なし
5000.5 秒
20002 秒
1000010 秒
ユースケース
ローディング状態テスト: ローディング UI が正しく表示されるかテスト
タイムアウト処理テスト: タイムアウト処理が正しく動作するかテスト
低速ネットワークシミュレーション: 低速ネットワーク環境での動作確認
競合状態テスト: 複数リクエストの順序依存問題のテスト
注意: 遅延はレスポンスパススルー が有効な場合でも適用されます。実サーバーのレスポンス時間に加えて、指定した遅延が追加されます。
OpenAPI インポート
OpenAPI (YAML/JSON) 定義ファイルを読み込み、モックルールを自動生成できます。

対応フォーマット
OpenAPI 3.xOpenAPI 3.0 / 3.1 仕様に対応
YAML / JSONどちらの形式でも読み込み可能
主な機能
| 機能 | 説明 |
|---|---|
| 外部参照解決 | $ref: './paths/users.yaml' などの外部ファイル参照を自動解決 |
| フォルダ自動作成 | エンドポイントごとにフォルダを作成し、ルールを整理 |
| ルール生成 | 正常系 (2xx) は有効状態、エラー系 (4xx/5xx) は無効状態で作成 |
パス変換
OpenAPI のパスパラメータは、Mimicry のワイルドカードに自動変換されます。
# OpenAPI 定義
/users/{userId}/posts/{postId}
# Mimicry のパターンに変換
/users/*/posts/*レスポンス生成
以下の優先順位でレスポンスボディを自動生成します。
example単一の例が定義されている場合examples複数の例から最初の 1 つを使用schemaスキーマからサンプルデータを生成使い方
- 1
サイドバーの OpenAPI Import ボタンをクリック
- 2
OpenAPI 定義ファイル (YAML/JSON) を選択
- 3
プレビューでフォルダ・ルール構成を確認
- 4
Import ボタンでモックルールを一括作成
ヒント: インポート前にプレビューでフォルダ構成とルール数を確認できます。外部参照を含む大きな OpenAPI 定義でも、自動的に解決して正しくインポートされます。