ステップ 4: API をテストする

このページは Apigee と Apigee ハイブリッドに適用されます。

Apigee Edge ドキュメントを表示する

デプロイした helloworld API をテストするには、Apigee in VS Code の [Terminal] タブをクリックし、次の curl 呼び出しを入力します。

curl 0:8998/helloworld

注: このセクションの例では、ホスト値に 0 を使用し、ポート値に 8998 を使用します。ポート値は、Apigee エミュレータの管理の説明に従って構成できます。0 の使用時にエラーが発生した場合は、0 を localhost に置き換えてください。

curl localhost:8998/helloworld

次のエラーメッセージが表示されます。

ターミナルタブでの API の呼び出しと認証エラー

API プロキシの作成時に API キーベースの認証を有効にしたため、API を呼び出すときに apikey クエリパラメータを使用して API キーを渡す必要があります。

API キーを取得するには、テストバンドルを作成し、次のテストリソースを構成する必要があります。

API をバンドルしてデベロッパーが使用できるようにするために使用する API プロダクト
API にアクセスするアプリを作成するデベロッパー
API キーを使用して API にアクセスできるようにするデベロッパーアプリ

テストリソースを構築してエクスポートし、API キーを取得して、API を再テストします。

テストバンドルを作成します。
1. [Apigee] セクションの tests フォルダにカーソルを合わせ、をクリックします。
  
  [Create test bundle] ウィザードが開きます。
2. テストバンドル名として「mytestbundle」と入力し、Enter キーを押します。
  テストバンドルが作成されます。
3. [Apigee] セクションで [mytestbundle] フォルダを開いて内容を表示します。
API プロダクトのテストリソースを構成します。
1. [Apigee] セクションの [products.json] ファイルにカーソルを合わせ、をクリックします。
  
  [Create API product] ウィザードが開きます。
2. API プロダクトの名前として「myproduct」と入力し、Enter キーを押して確定してから、次に進みます。
3. API プロダクトの説明として「myproduct」と入力し、Enter キーを押して確定してから、次に進みます。
4. [helloworld] を選択して API プロダクトに API プロキシを追加し、[OK] をクリックします。
  次のとおり、新しい API プロダクトが構成されて products.json ファイルがエディタで開きます。
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "scopes": [],
    "environments": [],
    "apiResources": [
      "/",
      "/*",
      "/**"
    ],
    "quota": "100",
    "quotaInterval": "1",
    "quotaTimeUnit": "minute",
    "name": "myproduct",
    "displayName": "myproduct",
    "proxies": [
      "helloworld"
    ]
  }
]
```
デベロッパーテストリソースを構成します。
1. [Apigee] セクションの [developers.json] ファイルにカーソルを合わせ、をクリックします。
  
  [Create developer] ウィザードが開きます。
2. プロンプトで次の値を入力し、Enter キーを押して確定してから次に進みます。
  - デベロッパーのメールアドレス: ahamilton@example.com
  - ユーザー名: ahamilton
  - 名: Alex
  - 性: Hamilton
  次のとおり、新しいデベロッパーが構成されて developers.json ファイルがエディタで開きます。
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "email": "ahamilton@example.com",
    "userName": "ahamilton",
    "firstName": "Alex",
    "lastName": "Hamilton"
  }
]
```
デベロッパーアプリのテストリソースを構成します。
1. [Apigee] セクションの developerapps.json ファイルにカーソルを合わせ、をクリックします。
  
  [Create developer app] ウィザードが開きます。
2. アプリのオーナーとして [ahamilton@example.com] を選択します。
3. 次のプロンプトセットで次の値を入力し、Enter キーを押して確定してから、次に進みます。
  - アプリ名: myapp
  - 説明: myapp
  - コールバック URL: 空欄
4. [myproduct] を選択してアプリに追加し、[OK] をクリックします。
5. 有効期限に [never] を選択します。
  次のとおり、新しいアプリが構成されて developerapps.json ファイルがエディタで開きます。
```
[
  {
    "attributes": [
      {
        "name": "sample_attribute_0",
        "value": "sample_attribute_value_0"
      }
    ],
    "developerEmail": "ahamilton@example.com",
    "name": "myapp",
    "displayName": "myapp",
    "callbackUrl": "",
    "apiProducts": [
      "myproduct"
    ],
    "expiryType": "never"
  }
]
```
テストリソースを Apigee Emulator にエクスポートします。
[Apigee] セクションで、mytestbundle テストバンドルにカーソルを合わせ、をクリックします。

注: 複数の Apigee エミュレータのコンテナが実行されている場合は、環境をデプロイするコンテナを選択するよう求めるプロンプトが表示されます。
次の図に示すように、アクティブなテストリソースは [Apigee Emulators] セクションに表示されます。
[Apigee Emulators] セクションの [アクティブなテストリソース] で、[アクティブなデベロッパーアプリ] をクリックします。
アクティブデベロッパーアプリの構成ファイルがエディタで開きます。次の図でハイライト表示しているように、このファイルには myproduct の認証情報が含まれています。
myproduct API プロダクトの consumerKey 値（引用符なし）をコピーします。
以下のように apikey クエリパラメータを使用して、curl 呼び出しで API キーを渡します。
```
curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY
```
以下のようなレスポンスが返されます。
```
Hello, Guest!
```

お疲れ様でした！ローカル環境で API が正常に実行されました。

次のステップでは、ターゲットエンドポイントを変更する方法を学習します。

次のステップ

1 2 3 4 （次へ）ステップ 5: ターゲットエンドポイントを変更する 6 7 8