フロントエンドチームがブロックされています。デザインは承認され、画面は半分構築済みですが、唯一の障害は、まだ存在しないAPIです。バックエンドはまだ開発スプリントの途中で、UIは実際に呼び出すものがありません。通常の応急処置はローカルモックですが、それはラップトップを閉じるまでは機能します。しかし、別のタイムゾーンにいるチームメイトが利用していたエンドポイントは利用できなくなります。
Apidog が Cloud Mock で埋めるのは、このギャップです。1つのマシン上でしか動作しないモックとは異なり、`mock.apidog.com` でホストされ、24時間稼働する公開URLが提供されます。フロントエンド、QA、およびパートナー開発者は、バックエンドコードが1行もリリースされる前に、現実的なエンドポイントにアクセスできます。まず、モックがチームにもたらすものの全体像を知りたい場合は、APIモックとは何か、いつ使用するかに関する入門記事が役立つでしょう。公開モックURLがリクエスト処理にどのように適合するかという仕組みについては、HTTPリクエスト/レスポンスモデルに関するMDNリファレンスが良い復習になります。
button
Cloud Mockとは何か、なぜローカルモックでは不十分なのか
Apidogは、設計するすべてのAPIに対してモックエンドポイントを生成します。デフォルトでは、そのモックはローカルモックであり、Apidogインスタンス上で動作し、マシンが稼働している間は応答します。シャットダウンすると、エンドポイントは応答を停止します。これは単独でのデバッグには問題ありません。しかし、他の誰かがそのURLに依存するようになると、すぐに破綻します。
Cloud Mock がその解決策です。これは、個々のマシンとは独立して存続する、継続的に利用可能なモックエンドポイントです。チームメイトのコンピューターがスリープ状態でも、あなたのラップトップがカバンの中にあっても、クラウドモックは24時間365日リクエストに応答し続けます。エンドポイントはApidogのホスト型サービス上に存在するため、可用性は誰がオンラインであるかには左右されません。
実用的な利点は、スムーズな引き継ぎです。契約を設計し、Cloud Mockを有効にして、1つのURLを共有するだけです。フロントエンドは現実的なデータに基づいて構築し、QAは実際のレスポンス形状に対してテストケースを作成し、連携するパートナーはすぐにクライアントの実装を開始できます。誰もバックエンドを待つ必要はなく、あなたにプロセスを稼働させ続けるよう待つ人もいません。これを地域間で調整している場合、グローバルチームとモックサーバーおよび環境を共有するの記事で、ワークフローについて詳しく説明されています。
Cloud Mockを有効にして公開URLを取得する
実際のAPIを使って手順を見ていきましょう。例えば、顧客レコードのリストを返す `GET /users` エンドポイントを持つ `users` サービスを構築しているとします。それを共有可能なクラウドエンドポイントにする方法を説明します。
ステップ1：Cloud Mockを有効にする
プロジェクトを開き、プロジェクト設定 > 機能設定 > モック設定 に移動します。Cloud Mock をオンに切り替えます。これは、モックをローカルでのみ提供するのではなく、Apidogの常時稼働サービス上でホストするようApidogに指示するスイッチです。
これはプロジェクトごとに一度だけ行います。有効になると、プロジェクト内のすべてのエンドポイントは、ローカルモックURLと並行してクラウドモックURLを取得します。
ステップ2：クラウドモックURLをコピーする
共有したいエンドポイントを開きます（この場合は GET /users）。その モック タブに移動し、クラウドモックURLをコピーします。以下のようなURLが得られます。
https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi
パス構造は `mock.apidog.com/m1/--/` のパターンに従います。Apidogが自動で構築するため、手動で組み立てる必要はありません。ドキュメントはこれを固定テンプレートとして公開するのではなく例として示しているため、自分で構築しようとするのではなく、コピーしたURLを信頼できる情報源として扱ってください。
ステップ3：Apidog内でモックを即座にテストする
URLを誰かに渡す前に、期待する結果が返されることを確認してください。同じ モック タブで、モックURLに対してテストリクエストを送信します。Apidogはリクエストを発行し、その場でレスポンスを表示します。生成されたデータが正しいかどうかをすぐに確認できます。
GET /users のモックは次のように返されることがあります。
[
{
"id": 1,
"name": "Amelia Turner",
"email": "amelia.turner@example.com",
"city": "Portland"
},
{
"id": 2,
"name": "Marcus Bell",
"email": "marcus.bell@example.com",
"city": "Austin"
}
]
これらの値はハードコードされていません。Apidogはスキーマのフィールド名と型を読み取り、それらに一致するもっともらしいデータを生成します。これが、実際の見た目のテーブルをレンダリングするフロントエンドにとってモックが役立つ理由です。
ステップ4：ブラウザでURLを開く
GETリクエストの場合、クラウドモックURLはWebブラウザで直接機能します。アドレスバーに貼り付けると、JSONレスポンスが表示されます。これは、非技術系の関係者に手渡せる最速の健全性チェックです。クライアントもcurlも不要で、データを返すリンクがあるだけです。
簡単な確認以上のことについては、フロントエンドは他のエンドポイントと同様に呼び出します。
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
これが全体の手順です。エンドポイントを設計し、Cloud Mockを有効にし、URLをコピーすれば、チームのブロックは解消されます。
トークン認証でモックを保護する
公開URLは便利ですが、時には便利すぎることがあります。モックが未リリース機能や公開したくないパートナー連携を反映している場合、アクセスを制限できます。
プロジェクト設定 > 機能設定 > モック設定 に移動し、アクセス許可を トークン認証 に設定します。これが有効になると、すべてのリクエストは有効な apidogToken を含む必要があり、含まれていないリクエストは拒否されます。トークンは以下の3つの方法で提供できます。
コピーしたURLですでに使用されているように、URLクエリ文字列パラメーターとして：
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
URLやサーバーログにトークンが残らないように、リクエストヘッダーとして：
curl "https://mock.apidog.com/m1/2689726-0-default/users" \
-H "apidogToken: GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
または、フォームボディを送信するクライアントに適した form-data または x-www-form-urlencoded リクエストのボディパラメーターとして、apidogToken という名前で。
フロントエンドコードでは、ヘッダー方式が通常最もクリーンです。これにより、トークンが完全なURLをログに記録するものから除外され、認証情報がリソースパスから分離されます。
const res = await fetch(
"https://mock.apidog.com/m1/2689726-0-default/users",
{ headers: { apidogToken: "GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi" } }
);
const users = await res.json();
注意すべき点：プレーンなURLをすでに共有した後にトークン認証を有効にした場合、すべての利用者はトークンを追加する必要があります。追加しないと、彼らの呼び出しが失敗し始めます。QAやパートナーが拒否されたリクエストに直面しないよう、切り替えを調整してください。
ロケールで現実的かつ地域に合わせたデータを生成する
すべてのレコードに対して "name": "string" を返すモックは、UIに何も教えません。実際の名前、住所、電話番号を返すモックは、実際のデータが届く前に、フロントエンドがレイアウトのバグ、テキストのオーバーフロー、書式設定の問題を検出するのに役立ちます。Apidogは内部で Faker.js を使用してこれを処理しており、ロケール制御は国際的な製品にとって真に役立つ部分です。
デフォルトのロケールの仕組み
デフォルトでは、Fakerはプロジェクトの言語設定に従います。これは プロジェクト設定 > 基本設定 で設定され、そこで選択した言語が生成されるすべてのモック値のデフォルトロケールになります。プロジェクトをフランス語に設定すると、フィールドごとに何も作業することなく、フランス語風味のモック名や住所が返されます。
プロジェクト全体のロケールをオーバーライドする
プロジェクトの言語とは異なる特定のロケールでモックデータが必要な場合は、それをオーバーライドできます。プロジェクト設定 > 機能設定 > モック設定 に移動し、ドロップダウンからFakerロケールを選択します。このオーバーライドは、プロジェクト内のすべてのフィールドにおいて、基本設定の言語デフォルトよりも優先されます。
これは国際化をテストする際に便利です。プロジェクトのロケールを日本に設定すると、生成されるすべての住所、名前、電話番号がその地域を反映するため、非ラテン文字スクリプトや異なる住所形式に対してUIがどのように機能するかを確認できます。この種のスキーマ認識型データの自動生成はそれ自体が一つのトピックであり、Apidogのスマートモックとそのスキーマ読み込み方法に関するウォークスルーで、生成側が詳しく説明されています。
フィールドごとにロケールをオーバーライドする
顧客リストが複数の地域を混在させるなど、一部のフィールドだけを他のフィールドとは異なるロケールにしたい場合があります。その場合、モック表現内で locale パラメーター を使用してロケールを直接設定できます。
{{$person.fullName(locale='ja')}}
これにより、そのフィールドのみに 田中 太郎 のような日本語の名前が出力され、残りのレスポンスはプロジェクトのロケールに従います。優先順位は3段階です。フィールドレベルのロケールはプロジェクトレベルのロケールを上書きし、プロジェクトレベルのロケールは基本設定の言語デフォルトを上書きします。したがって、合理的なプロジェクトのデフォルトを設定し、例外が本当に必要な場合にのみフィールドレベルのオーバーライドを使用します。
範囲に関する正直な注意点：ドキュメントでは ja を例として示しており、サポートされているロケールの完全なリストは公開されていません。したがって、それを利用する前に、Apidogのモックドキュメントでターゲット地域の正確なコードを確認してください。Faker自身の規約は、Faker.jsロケールリファレンスで文書化されています。
タイムゾーンも合わせる
時間に関する並行した制御があります。プロジェクトレベルのデフォルトは プロジェクト設定 > 機能設定 > モック設定 にあり、モック表現内の timeZone パラメーター を使ってフィールドごとにオーバーライドできます。UIがタイムスタンプをレンダリングする場合、これにより生成された createdAt の値は、サーバーが存在する場所ではなく、シミュレートしている地域と一貫するようになります。
ロケールとタイムゾーンの制御により、同じエンドポイントスキーマから、日本のユーザーベース、ドイツのユーザーベース、または混合された国際的なグループを説得力を持って模倣するモックを立ち上げることができます。これが解き放つ広範なシナリオについては、実用的なAPIモックのユースケースのまとめが参考になるでしょう。
Cloud Mockとセルフホスト型モックの比較
Cloud MockはApidogのホスト型オプションであり、ほとんどのチームに対応しています。組織がデータ所在地の規制や、ベンダーのクラウド経由でテストトラフィックをルーティングすることに反対するポリシーを持っている場合、Apidogは独自のインフラストラクチャでモックサービスを実行することもサポートしています。トレードオフは単純です。クラウドオプションはセットアップ不要で常時稼働しますが、セルフホスティングはサービスを自分で実行するコストで制御を提供します。そのような状況の場合、Apidogモックサーバーのセルフホスティングのガイドが参考になります。ホスト型オプションを比較検討しているチームのために、オンラインAPIモックツールの比較が状況を説明しています。
プラン制限について、簡潔な答えは次のとおりです。ここに記載されているCloud Mockとロケール機能には特定のプラン要件が明記されていません。したがって、ブログ記事の数字を鵜呑みにするのではなく、ご自身のアカウントで現在の利用可能性を確認するのが誠実な行動です。Apidogをダウンロードして、ワークスペースに含まれるものを正確に確認するために、エンドツーエンドのフローを試すことができます。
Apidog CLIでワークフローを自動化する
Apidogでのモックは、GUIとクラウドの機能です。モックレスポンスはエンドポイントスキーマから自動的に生成され、Apidogのホスト型エンジンによって提供されます。ターミナルで実行するものではありません。したがって、正直なところ、Apidog CLIはモックサーバーを起動したり提供したりしません。その役割は、モックへの入力を正確に保つことです。
CLIやCursorまたはClaude CodeのようなAIコーディングエージェントは、プロジェクト内のエンドポイントとスキーマを作成および更新できます。クラウドモックはそれらのスキーマを読み取ってデータを生成するため、仕様を最新に保つことで、APIの進化に合わせてモックの出力も正確に保たれます。エージェントツールを使用してフィールドを追加すると、手動で編集することなくモックに反映されます。
そして、モックがフロントエンドの作業をブロック解除し、実際のバックエンドがデプロイされたら、同じプロジェクトのテストシナリオがそれに対してヘッドレスで実行されます。CLIの実行コマンドは、モックが記述したのと同じ契約に対してライブバックエンドを検証します。
apidog run -t <scenario_id> -e <env_id> -r cli
この単一のコマンドは、保存されたテストシナリオを環境に対して実行し、結果を報告するため、UIをブロック解除したモックと、バックエンドを検証するテストの両方が、単一の信頼できる情報源に紐づきます。Apidogでシナリオを開き、-t シナリオIDと -e 環境IDがすでに埋められた生成済みコマンドをコピーしてください。手動でフラグを組み立てる必要はありません。これをパイプラインに組み込む方法は、CI/CDパイプラインでApidogを実行するガイドで説明されています。
よくある質問
Apidogを閉じてもクラウドモックURLは動作し続けますか？
はい、それがCloud Mockの最大の利点です。ホストしているマシンがシャットダウンすると応答を停止するローカルモックとは異なり、クラウドモックはApidogのインフラストラクチャから提供され、24時間365日利用可能です。あなたのコンピューターがオンになっているかどうかに関わらず、チームメイトはそれにアクセスできます。
クラウドモックURLをブラウザで直接使用できますか？
GETリクエストの場合は、はい。apidogToken クエリパラメーターを含む完全なURLをアドレスバーに貼り付けると、JSONレスポンスが表示されます。他のメソッドの場合、またはトークンをURL履歴に残さないようにするには、curlやフロントエンドクライアントのようなツールで呼び出し、トークンをヘッダーとして渡してください。
トークンを含まないリクエストはどうなりますか？
アクセス許可をトークン認証に設定している場合、有効な apidogToken が含まれていないリクエストはすべて拒否されます。クエリ文字列パラメーター、リクエストヘッダー、またはフォームリクエストのボディパラメーターとして提供してください。プレーンなURLを共有した後にトークン認証を有効にする場合は、呼び出しが失敗し始める前にトークンを追加できるよう、利用者に通知してください。
特定の国に一致するモックデータを取得するにはどうすればよいですか？
基本設定でプロジェクトのロケールを設定するか、機能設定 > モック設定でプロジェクト全体をオーバーライドするか、モック表現内の locale パラメーター（例：{{$person.fullName(locale='ja')}}）で単一のフィールドをオーバーライドします。フィールドレベルはプロジェクトレベルに優先し、プロジェクトレベルは基本設定のデフォルトに優先します。スマートモックのウォークスルーでは、スキーマ認識型生成がこれにどのように関連しているかを示しています。
Cloud Mockとヘッドレスモックツールのどちらを使用すべきですか？
Cloud Mockは、API設計に紐付けられたホスト型でメンテナンス不要のエンドポイントを求めるチームに適しています。GUIが一切ない自動ビルドにモックを組み込む必要がある場合、ヘッドレスモックツールの調査で、各オプションとその適合性が比較されています。OpenAPI Initiative の仕様はこれらのツールのほとんどを支えているため、どのルートを選択してもクリーンな仕様が報われます。
まとめ
あなたのラップトップ上でのみ動作するモックは、たった一人しかブロック解除できません。Cloud Mockはそれを公開 mock.apidog.com のURLに変え、チーム全体がそれに基づいて開発できます。アクセス制限が必要な場合はトークン認証を、特定の地域でデータがリアルに見える必要がある場合はロケール制御を使用できます。エンドポイントを設計し、トグルを切り替え、リンクを共有すれば、フロントエンドはバックエンドを待つ必要がなくなります。Apidogをダウンロードして、最初の共有可能なクラウドモックを無料で、クレジットカードなしで設定しましょう。
button