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

このページの内容は Apigee と Apigee ハイブリッドに該当します。

Apigee Edge のドキュメントを表示します。

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

curl 0:8998/helloworld

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

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

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

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

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

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

curl localhost:8998/helloworld

テストリソースをビルドしてエクスポートする

テストバンドルを作成します。
1. tests フォルダにカーソルを合わせ、をクリックします。
  
  [Create test bundle] ウィザードが開きます。
2. テストバンドル名として「mytestbundle」と入力し、Enter キーを押します。
  テストバンドルが作成されます。
3. mytestbundle フォルダを開いて内容を表示します。
API プロダクトのテストリソースを構成します。
1. [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. 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. developerapps.json ファイルにカーソルを合わせ、をクリックします。
  
  [Create developer app] ウィザードが開きます。
2. アプリのオーナーとして [ahamilton@example.com] を選択します。
3. 次のプロンプトセットで次の値を入力し、Enter キーを押して確定してから、次に進みます。
  - アプリ名: myapp
  - 説明: myapp
  - コールバック URL: 空欄
  - [myproduct] を選択してアプリに追加し、[OK] をクリックします。
  - 有効期限に [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 にエクスポートします。
mytestbundle テストバンドルにカーソルを合わせ、をクリックします。

注: 複数の Apigee エミュレータのコンテナが実行されている場合は、環境をデプロイするコンテナを選択するよう求めるプロンプトが表示されます。
次の図に示すように、アクティブなテストリソースは [Apigee Emulators] セクションに表示されます。

API キーを取得する

デベロッパーアプリの API キー認証情報を取得します。

[emulators] セクションの [Active test data] で、[Active developer apps] をクリックします。
アクティブデベロッパーアプリの構成ファイルがエディタで開きます。次の図でハイライト表示しているように、このファイルには myproduct の認証情報が含まれています。
```
<p><img src="/apigee/docs/api-platform/images/vscode-consumerkey.png" alt="Developer apps with the consumerKey value highlighted."></p>
```
myproduct API プロダクトの consumerKey 値（引用符なし）をコピーします。

API をテストする

API キーを使用して API をテストします。

以下のように apikey クエリパラメータを使用して、curl 呼び出しで API キーを渡します。
```
curl 0:8998/helloworld?apikey=API_KEY
```
以下のようなレスポンスが返されます。
```
Hello, Guest!
```

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

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

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