高度な機能

リクエスト条件マッチング

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

遅延なし

500

0.5 秒

2000

2 秒

10000

10 秒

ユースケース

  • ローディング状態テスト: ローディング UI が正しく表示されるかテスト

  • タイムアウト処理テスト: タイムアウト処理が正しく動作するかテスト

  • 低速ネットワークシミュレーション: 低速ネットワーク環境での動作確認

  • 競合状態テスト: 複数リクエストの順序依存問題のテスト

注意: 遅延はレスポンスパススルー が有効な場合でも適用されます。実サーバーのレスポンス時間に加えて、指定した遅延が追加されます。

OpenAPI インポート

OpenAPI (YAML/JSON) 定義ファイルを読み込み、モックルールを自動生成できます。

OpenAPI インポート画面。ファイル選択後にフォルダとルールのプレビューが表示される

対応フォーマット

OpenAPI 3.x

OpenAPI 3.0 / 3.1 仕様に対応

YAML / JSON

どちらの形式でも読み込み可能

主な機能

機能説明
外部参照解決$ref: './paths/users.yaml' などの外部ファイル参照を自動解決
フォルダ自動作成エンドポイントごとにフォルダを作成し、ルールを整理
ルール生成正常系 (2xx) は有効状態、エラー系 (4xx/5xx) は無効状態で作成

パス変換

OpenAPI のパスパラメータは、Mimicry のワイルドカードに自動変換されます。

# OpenAPI 定義
/users/{userId}/posts/{postId}

# Mimicry のパターンに変換
/users/*/posts/*

レスポンス生成

以下の優先順位でレスポンスボディを自動生成します。

1
example単一の例が定義されている場合
2
examples複数の例から最初の 1 つを使用
3
schemaスキーマからサンプルデータを生成

使い方

  1. 1

    サイドバーの OpenAPI Import ボタンをクリック

  2. 2

    OpenAPI 定義ファイル (YAML/JSON) を選択

  3. 3

    プレビューでフォルダ・ルール構成を確認

  4. 4

    Import ボタンでモックルールを一括作成

ヒント: インポート前にプレビューでフォルダ構成とルール数を確認できます。外部参照を含む大きな OpenAPI 定義でも、自動的に解決して正しくインポートされます。