第 4 步:测试 API

本页面适用于 ApigeeApigee Hybrid

查看 Apigee Edge 文档。

如需测试已部署的 helloworld API,请点击 Apigee Cloud Code 中的 Terminal 标签页,然后输入以下 curl 调用:

curl 0:8998/helloworld

显示以下错误消息:

在 Terminal 标签页中调用 API 并收到授权错误

您在创建 API 代理时启用了基于 API 密钥的身份验证,所以需要在调用 API 时使用 apikey 查询参数传递 API 密钥。

要获取 API 密钥,您需要创建一个测试软件包并配置以下测试资源:

  • 用于捆绑 API 并将其提供给开发者的 API 产品

  • 将创建访问该 API 的应用的开发者

  • 能够使用 API 密钥访问该 API 的开发者应用

构建和导出测试资源,获取 API 密钥,然后重新测试 API。

  1. 创建测试软件包:
    1. 将光标放在 Apigee 部分中的 tests 文件夹上,然后点击 “创建”图标

      将光标放在 tests 文件夹上时显示 +

      此时 Create test bundle 向导会打开。

    2. 输入 mytestbundle 作为测试软件包名称,然后按 Enter 键。

      测试软件包创建完成。

    3. 展开 Apigee 部分中的 mytestbundle 文件夹以查看其内容。

      包含 developerapps.json、developers.json、maps.json 和 products.json 文件的 tests 文件夹

  2. 配置 API 产品测试资源:
    1. 将光标放在 Apigee 部分中的 products.json 文件上,然后点击 “创建”图标

      将光标放在 products.json 上时显示 +。

      此时 Create API product 向导会打开。

      Create API product 向导的第一页

    2. 输入 myproduct 作为 API 产品的名称,然后按 Enter 键确认并继续。
    3. 输入 myproduct 作为 API 产品的说明,然后按 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"
          ]
        }
      ]
  3. 配置开发者测试资源:
    1. 将光标放在 Apigee 部分中的 developers.json 文件上,然后点击 “创建”图标

      将光标放在 developers.json 上时显示 +。

      此时会打开 Create developer 向导。

      Create API product 向导的第一页

    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"
        }
      ]
  4. 配置开发者应用测试资源:
    1. 将光标放在 Apigee 部分中的 developerapps.json 文件上,然后点击 “创建”图标

      将光标放在 developerapps.json 上时显示 +。

      此时 Create developer app 向导会打开。

      Create API product 向导的第一页

    2. 选择 ahamilton@example.com 作为应用的所有者。
    3. 在下一组提示中输入以下值,然后按 Enter 键确认并继续:
      • 应用名称:myapp
      • 说明:myapp
      • 回调网址:留空
    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"
        }
      ]
  5. 将测试资源导出到 Apigee 模拟器。

    在 Apigee 部分中,将光标放在 mytestbundle 测试软件包上,然后点击 “导出测试”图标

    活跃的测试资源,包括 API 产品、开发者和开发者应用

    活跃的测试资源显示在 Apigee 模拟器部分中,如下图所示。

    活跃的测试资源,包括 API 产品、开发者和开发者应用

  6. 在 Apigee 模拟器部分中的“活跃的测试资源”(Active test resources) 下,点击活跃的开发者应用 (Active Developer apps)。

    活动的开发者应用配置文件会在编辑器中打开。该文件包含 myproduct 的凭据,如下图所示。

    突出显示 consumerKey 值的开发者应用。

  7. 复制 myproduct API 产品的 consumerKey 值(不含引号)。
  8. 使用 apikey 查询参数在 curl 调用中传递 API 密钥,如下所示:
    curl 0:8998/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY

    返回以下响应:

    Hello, Guest!

恭喜!您已在本地环境中成功运行 API。

在下一步中,您将了解如何更改目标端点。

1 2 3 4 (下一步)第 5 步:更改目标端点 6 7 8