Apidog

オールインワンのAPI開発プラットフォーム

API設計

API仕様書生成

APIデバッグ

API Mock

APIテスト自動化

無料登録
Home / 操作ガイド / すごく簡単!3ステップでAPIモックを実装する方法

すごく簡単!3ステップでAPIモックを実装する方法

APIモックが必要となる場合、どうすればいいですか?本文では、一番使いやすいAPI管理ツールのApidogを使って、3ステップだけで、APIモックを簡単に実装する方法を皆さんに紹介します。

APIモックとは、実際のAPIと同様に振る舞う、テスト用の仮想的なAPIのことです。つまり、実際のAPIが提供するデータや機能に対して、APIモックが同じように応答を返すように設計されます。APIモックアップの略語です。

APIモック、もしくはモックアップは、様々な場合で役立ちます。特に開発者がAPIを実際に実装する前に、APIの動作をシミュレートしてテストすることができるため、効率的なアプリケーションの開発を促進します。また、APIモックを使用することで、実際のAPIが利用可能になる前に、アプリケーションのテストを行うことができます。

button

それでは、APIモックが必要となる場合、どうすればいいですか?次は、一番使いやすいAPI管理ツールのApidogを使って、3ステップだけで、APIモックを簡単に実装する方法を皆さんに紹介します。

完璧なモックアップツール - Apidog

Apidogは、非常に強力なAPI管理ツールです。このツールによって、APIの設計、開発とデバッグ、モック、自動化テストなども実現されます。完全なAPIソリューションを提供しているApidogには、Postman、JMeter、Swagger、Mockの機能も全て備えています。

APIモックを行いたい場合、Apidogは必ず役立ちます。内蔵されているMockエンジンは、現実みたいなデータをモックできるようになります。Apidogのモック機能によって、バックエンドのAPI開発が完了するまで待つ必要がなく、すぐAPIモックが返してくれるデータを用いて、開発プロセスを前に進めることができます。

ApidogでAPIモックを簡単に実行する方法

それでは、Apidogを使ってAPIモックを行うには、どうすればいいですか?すごく簡単な3ステップだけでAPIモックを実行できるので、次の詳細ガイドを参照してみましょう。

button

ステップ⒈ プロジェクトの作成

Apidogでのプロジェクトは、複数のAPIを管理するために利用されています。APIは、いずれかのプロジェクトに属しなければなりません。

Apidogを開き、初期画面で「新しいプロジェクト」ボタンをクリックして、プロジェクトを新規に作成できます。

Apidogでプロジェクトを新規に作成

ステップ⒉ APIの新規作成

ここでユーザーの詳細情報を取得するAPIの作成を例にして、APIの新規作成機能を皆さんに紹介します。

  • リクエスト方法:GET
  • エンドポイント:api/user/{id}、その中でidがpathパラメータで、ユーザーのIDを表します。
  • レスポンスの種類:json
  • レスポンスの内容:
{
  id: number, // ユーザーのid
  name: string, // ユーザー名
  gender: 1 | 2, // 性別:1 
  phone: string, // 携帯番号
  avatar: string, // プロフィール写真のURL
}

新規に作成したプロジェクトの初期ページの「+」ボタンをクリックして、APIを新規に作成します。

プロジェクトでAPIを新規に作成

上記の項目をそれぞれのボックスに記入して保存します:

APIの情報を記入
APIのレスポンスの例を設定

ここでユーザーの詳細情報に関するAPIを作成できました。その同時に、Apidogは記入したフィールドやパラメータに従って、モックデータを自動的に作成します。Mockの下の「Request」をクリックすると、Mockのレスポンスを確認することができます。

APIのRequestを送信

それから、Requestの画面で「送信」ボタンをクリックして、レスポンスのデータを取得できます。

モックデータを取得
button

ステップ⒊モックに利用されるマッチングルールの設定

皆さんも気づいたのでしょうか?nameがstring型と設定しているが、漢字の名前が返されてしまいました。phoneがstring型としているが、携帯番号が返されてしまいました。avatarがstring型と設定しているが、画像のURLが返されてしまいましたね。それはなぜですか?

Apidogには内蔵のモックマッチングルールがあるからです。事前の設定がなければ、Apidogはデフォルトで内蔵のマッチングルールに従って、データを生成できます。これらのマッチングルールが、「プロジェクト設定」→「機能設定」→「Mock設定」で変更できます。

Apidogのモックルール

また、APIの変更ページで、特定のフィールドに特定のモックルールを振り分けることもできます。

特定のフィールドに特定のモックルールを振り分け
button

ガイド:Apidogのモックルールの解説

Apidogのモックのマッチングルール

フィールドがあるマッチングルールに一致する場合、モックルールを満たすランダムの内容を返します。

フィールドが全てのマッチングルールに一致していない場合、当該フィールドの種類を満たすランダムの内容を返します。

マッチングルールは3つの種類をサポート

⒈ワイルドカード:*は、0または任意の複数の文字にマッチします。?は、1つの任意の文字をマッチします。例えば、*nameはusername、nameなどにマッチできます。

⒉正規表現

⒊完全なマッチ

Mock.jsにも対応可能

MockルールはMock.jsと完全に互換性があり、Mock.jsにはない文法(例えば携帯電話番号@phone)も修正されています。よく使われるのは:

1.@Integer:整数。@Integer(min, max)

2.@String:文字列。@String( length ):長さの文字列を指定する

3.@Regexp( regexp ):正則

4.@userName:ユーザーの名前

5.@Url:ウェブサイト

実際の開発プロセス中に、より複雑な状況に遭ったことがよくあります。例えば:違うパラメータによって、違うレスポンスの内容を返します。Idが1の場合、正常なユーザー情報を返しますが、Idが2の時、エラーを報告します。Apidogは、このような状況にも対応できます。

まとめ

本文では、Apidogという高機能のAPI管理ツールを使って、APIモックを行う方法を皆さんに紹介しました。もちろん、APIモックの他に、Apidogは、API仕様書生成、APIのデバッグ、APIテストの自動化などの機能にも対応しています。興味やニーズがある方は、Apidogのホームページにアクセスして、もっと詳しく了解しましょう。

button

Apidogのニュースレターを購読する

今すぐ購読すると、いつでもApidogから更新情報と最新観点を手に入れることができます。

有効なメールアドレスを入力してください。
ネットワークエラー、後で再試行してください
購読していただきありがとうございます!