第 6 步:发布 API

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

在此步骤中,您需要执行以下步骤将 API 发布到该门户:
1. 创建 OpenAPI 规范
2. 根据规范创建 API 代理
3. 创建 API 产品
4. 将 API 发布到您的门户

第 1 步:创建 OpenAPI 规范

每个 OpenAPI 规范在整个 API 生命周期中都是可信来源。从开发到发布的 API 生命周期的每个阶段都使用相同的规范。

如需创建 OpenAPI 规范,请执行以下操作

  1. 在左侧导航栏中依次选择 Develop > Specs,打开 Specs 页面。
  2. 点击 + 规范 > 导入网址
  3. 在“导入”对话框中输入以下信息:
  4. 导入名称:helloworld
  5. 导入网址:https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml

  6. 点击导入

第 2 步:根据规范创建 API 代理

根据描述 API 的 OpenAPI 规范创建 API 代理。

如需根据 OpenAPI 规范创建 API 代理,请执行以下操作:

  1. 在“规范”页面上,将光标置于 helloworld 规范上方,以显示操作菜单。
  2. 点击 以根据规范生成 API 代理。
    系统会打开“构建代理”向导,并使用 OpenAPI 规范中的值预填充“详细信息”页面。
  3. 按照以下说明修改说明字段:适用于 hello world 的 API 代理 (API proxy for hello world)。
  4. 点击下一步
  5. 政策页面上,执行以下操作:

    • 安全性:授权 (Security: Authorization) 下,选择直通(无授权)(Pass through (no authorization))。
    • 安全性:浏览器 (Security: Browser) 下,选择添加 CORS 标头 (Add CORS headers)。

    “创建代理”向导中的“通用政策”(Common policies) 页面,其中选中了“直通”(Pass through) 和“添加 CORS 标头”

  6. 点击下一步

  7. (Flows) 页面上,确保选中所有操作,然后点击下一步 (Next)。
    构建代理流

  8. 在“Virtual Hosts”(虚拟主机)页面上,确保已选择所有虚拟主机,然后点击 Next(下一步)。

  9. 摘要页面上,在可选部署 (Optional Deployment) 下选择要部署到的环境。

  10. 点击创建

在“摘要”页面上,您会看到一条确认消息,告知您新 API 代理已成功创建并已部署到测试环境。

第 3 步:创建 API 产品

创建一个 API 产品,其中包含您要向 API 使用方公开的 API 资源。

如需创建 API 产品,请执行以下操作

  1. 在左侧导航栏中选择发布 > API 产品 (API Products),打开“API 产品”页面。
  2. 点击 + API 产品
    系统会显示“新产品”页面。
  3. 输入 API 产品的产品详细信息
    注意:默认情况下,当您发布 API 产品时,“Display Name”和“Description”字段会显示在门户中。您可以在第 4 步:将 API 发布到您的门户中修改值。
    字段
    名称 Hello World
    显示名 Hello World
    说明 简单的 hello world 示例
    环境 选择在其中部署 API 代理的环境。
    有访问权限的应用 公开
    自动批准访问请求 已启用
    配额 (留空)
    允许的 OAuth 范围 (留空)
  4. API 资源下,点击添加代理以标识要添加到 API 产品的 API 代理。
    系统会显示添加 API 资源对话框。
  5. 点击 API 代理(如果尚未选择),然后从列表中选择 Mock-Target-API
  6. 点击添加
  7. 点击保存以保存该 API 产品。

    显示已设置所有字段的 Hello World API 产品

第 4 步:将 API 发布到您的门户

将 API 发布到您的门户,以便您的客户了解并使用 API。

如需将 API 发布到您的门户

  1. 转到到门户中的 API 页面:
    1. 在左侧导航栏中选择发布 > 门户
    2. 点击我的第一个门户 (My first portal) 行以打开该门户。
    3. 点击 API 目录以显示 API 页面。
  2. 点击 +
  3. 将 API 产品添加到目录 (Add an API product to the catalog) 对话框中,选择 Hello World,然后点击下一步
  4. API 详细信息 (API details) 下,配置以下选项:
    • 选择已发布(在目录中列出) (Published (listed in the catalog)) 以将 API 发布到您的门户。
    • 显示图片部分中,执行以下操作:
      1. 点击选择图片
      2. 选择图片对话框中,点击现有图片列表中的 home-background.jpg
      3. 点击选择
      4. 预览图片,然后点击选择
    • 对于类别部分,输入开始使用,然后按 Enter 键。

    让所有其他值保留为默认值。

  5. API 文档下,如需通过 OpenAPI 规范的快照自动生成 API 参考文档,请执行以下操作:
    1. 选择 OpenAPI 文档 (OpenAPI document)。
    2. 点击选择文档
    3. 选择我的规范标签(如果尚未选择)。
    4. 从规范列表中选择 helloworld
    5. 点击选择
  6. 点击保存以保存 API 详细信息。

    显示所有字段集的 Hello World API

如需查看 API 参考文档,请执行以下操作:

  1. 点击实时门户 (Live Portal) 以查看实时门户中的更改(如果已在另一个标签页中打开实时门户,请刷新该门户)。
  2. 在顶部导航栏中点击 API 以查看已发布的 API。
  3. 点击 Hello World 卡片以查看 API 参考文档。试用您的 API!

通过“试用此 API”面板发布的 Mock Target API


恭喜! 您已成功完成本教程。准备好了解更多内容了吗? 转到构建集成式门户