Smart Mock

Smart Mock は、追加の設定を必要とせず、API 仕様に基づいて現実的な API レスポンスを自動生成します。このインテリジェントなモックシステムは、スキーマを分析し、適切なテストデータを即座に生成します。

Smart Mock の仕組み

Smart Mock は、次の 3 つのソースからデータを生成し、以下の優先順位で適用します。

優先順位	ソース	説明
1	モックフィールド	レスポンス仕様プロパティ内のカスタム値または式
2	プロパティ名のマッチング	プロパティの型と名前に基づく自動データ生成
3	JSON Schema	スキーマルールによって制約された型ベースのデフォルト値

Smart Mock のインテリジェントなアルゴリズムは、プロパティ名を組み込みルールと照合し、型と名前に基づいて文脈に適したデータを生成します。

組み込みルールは、Settings → General Settings → Feature Settings → Mock Settings で表示および管理できます。

これらのルールでは、ワイルドカードまたは正規表現パターンを使用してプロパティ名を照合します。

組み込みルールがニーズを満たさない場合は、カスタムマッチングルールを作成できます。

Settings → General Settings → Feature Settings → Mock Settings に移動します

New をクリックしてカスタムルールを作成します

条件の詳細を定義し、モック式を指定します

カスタム条件に一致するプロパティは、指定されたモック式に従ってデータを生成します。

デフォルトの動作

プロパティ名がいずれのルールにも一致しない場合、Smart Mock はそのプロパティのデータ型に基づいてデフォルト値を生成します。

レスポンスプロパティの モックフィールド に指定された値は、名前ベースのマッチングよりも優先されます。

次のいずれかを入力できます。

固定値: 毎回返される静的な値

Faker ステートメント: さまざまなデータを生成するための動的な値式

生成されるすべてのモックデータは、API 仕様で定義された JSON Schema の制約に従います。

スキーマ制約	例	結果
文字列長	長さ 3〜5 のプロパティ `name`	自動モックされた "Richard" が "Richa" になります
列挙値	enum ["sold", "pending", "available"] を持つプロパティ `status`	3 つの値のいずれかを返します
数値範囲	最小値/最大値の境界を持つ整数	生成された値は範囲内に収まります
配列長	最小/最大要素数を持つ配列	生成された配列は要素数の制限に従います

すべてのプロパティ設定は最終的なモックデータに反映され、レスポンスが常に JSON Schema 仕様に準拠することを保証します。

モックロケール

Apidog はカスタマイズ可能なモックロケールに対応しており、対象地域または対象ユーザーに合ったさまざまな言語や形式で動的なテストデータを生成できます。モックロケールの設定について詳しくは、Mock language (Locales) を参照してください。