发布您的 API（原始版本）

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

如下文所述，将 API 发布到您的门户，以供应用开发者使用。

API 发布概览

向门户发布 API 的过程分为两个步骤：

1. 选择要发布到门户的 API 产品。
2. 通过 OpenAPI 规范的快照自动生成 API 参考文档，以便应用开发者了解您的 API。（如需详细了解快照，请参阅什么是 OpenAPI 规范的快照？）

将 API 发布到门户时，系统会自动对您的门户进行以下更新：

• 系统会将“API 参考”页面添加到您的门户
  “API 参考”页面会显示您通过 OpenAPI 规范的快照自动生成的 API 参考文档。开发者可以查看您的 API 文档，然后点击试用来发出 API 请求并查看输出。

  注意：您无法直接修改本页面的内容；它不会显示在您门户中的页面列表中。

  

• 将指向 API 参考页面的链接添加到 API 页面
  API 页面（包含在示例门户中）列出了发布到您的门户的所有 API，并随附了指向相应 API 参考文档的链接。

  注意：您无法直接修改本页面的内容；它不会显示在您门户中的页面列表中。

  

什么是 OpenAPI 规范的快照？

每个 OpenAPI 规范都用作 API 整个生命周期内的可靠来源。API 生命周期的各个阶段（从开发、发布到监控）都使用相同的规范。修改规范时，您需要了解所做的更改在 API 的其他生命周期阶段对 API 产生的影响，如修改规范时会发生什么情况？中所述。

发布 API 时，您需要截取 OpenAPI 规范的快照来生成 API 参考文档。该快照表示规范存储区中的特定规范版本。如果您使用规范编辑器修改了 OpenAPI 规范，可能需要再次截取规范的快照，以反映 API 参考文档中的最新更改。

向 API 代理添加 CORS 支持

在发布 API 之前，您需要向 API 代理添加 CORS 支持，以支持客户端跨源请求。

CORS（跨源资源共享）是一种标准机制，允许在网页中执行的 JavaScript XMLHttpRequest (XHR) 调用与来自非源网域的资源进行交互。CORS 是通常针对所有浏览器强制执行的同源政策实现的解决方案。例如，如果您从浏览器中执行的 JavaScript 代码向 Twitter API 发出 XHR 调用，该调用将失败。这是因为向您的浏览器提供网页的网域与提供 Twitter API 的网域不同。CORS 针对这个问题提供了一个解决方案，允许服务器在希望提供跨源资源共享的情况下“选择加入”。

如需了解如何在发布 API 之前向 API 代理添加 CORS 支持，请参阅向 API 代理添加 CORS 支持。

注意：大多数现代浏览器都会强制执行 CORS。查看支持的浏览器的完整列表。如需详细了解 CORS，请参阅 W3C 跨域资源共享建议。

探索“API”页面

如需访问“API”页面，请执行以下操作：

1. 选择发布 > 门户，然后选择您的门户。
2. 在门户首页上点击 API。

或者，您也可以在顶部导航栏的门户下拉菜单中选择 API。

系统会显示 API 列表。

如上图所示，您可以通过 API 页面执行以下操作：

• 查看门户上可用的 API 的详细信息
• 向门户添加 API
• 截取与 API 产品关联的 OpenAPI 规范的快照以更新 API 参考文档
• 在您的门户上发布或取消发布 API
• 管理门户中 API 的受众群体
• 修改关联的规范（请参阅使用规范编辑器创建规范）
• 从门户中移除 API
• 快速识别其关联 API 产品已从 Edge 中移除的“孤立”API，然后重新创建 API 产品或者从您的门户中删除此 API

向您的门户添加 API

注意：您最多可以向门户添加 100 个 API。

如需向您的门户添加 API，请执行以下操作：

1. 选择发布 > 门户，然后选择您的门户。
2. 在门户着陆页上点击 API。
   或者，您也可以在顶部导航栏的门户下拉菜单中选择 API。
3. 点击 + API（添加 API）。
   系统会显示“将 API 产品添加到门户”对话框。

4. 在对话框的“API 产品”标签页中，选择要添加到门户的 API 产品。
   

5. 点击下一步。

6. 选择要用于快照的来源。
   如果您使用 OpenAPI 规范创建了 API 产品中包含的 API 代理，请从下拉列表中选择该规范。
   

   或者，您也可以选择：

   • 无规范，然后在发布 API 后稍后添加一个，如拍摄规范的快照中所述。
   • 选择其他规范以选择或上传新规范。

7. 选中已发布复选框，以将 API 发布到您的门户。如果您还没准备好发布 API，请取消选择已发布。
   您可以稍后更改此设置，如在您的门户上发布或取消发布 API 中所述。

8. 在“受众群体”下，选择以下选项之一，以通过允许访问以下各项来管理 API 的受众群体：

   • 匿名用户：允许所有用户查看网页。
   • 已注册的用户：只允许注册用户查看该页面。

   您可以稍后更改此设置，如管理门户上 API 的受众群体中所述。

9. 点击完成。

拍摄规范的快照

发布 API 后，您可以随时截取 OpenAPI 规范的新快照，以更新在门户上发布的 API 参考文档。

如需截取 OpenAPI 规范的快照，请执行以下操作：

1. 选择发布 > 门户，然后选择您的门户。
2. 在门户着陆页上点击 API。
   或者，您也可以在顶部导航栏的门户下拉菜单中选择 API。
3. 将光标置于您想为其截取快照的 API 上以显示相关操作。

4. 点击 。

   注意：如果您的快照与所选的来源规范一致，系统会显示一条消息。

5. 从“快照来源”下拉菜单中选择现有规范，或选择选择其他规范以选择或上传新规范，用于生成 API 文档。或者，您也可以选择无规范来移除当前规范。

6. 点击更新快照（如果您选择了“无规范”，则点击移除快照）。

系统会根据规范生成 API 参考文档，并将其添加到“API 参考”页面。

在门户上发布或取消发布 API

如需在您的门户上发布或取消发布 API，请执行以下操作：

1. 选择发布 > 门户，然后选择您的门户。
2. 在门户着陆页上点击 API。
   或者，您也可以在顶部导航栏的门户下拉菜单中选择 API。
3. 将光标置于要发布或取消发布的 API 上。
4. 点击 。
5. 选中启用复选框以在您的门户中发布 API。取消选中启用以取消发布 API。
6. 点击保存。

管理门户中 API 的受众群体

通过为以下对象授予对您的门户的访问权限，管理门户上的 API 受众：

• 所有用户
• 仅限注册用户

如需管理门户中 API 的受众群体，请执行以下操作：

1. 选择发布 > 门户，然后选择您的门户。
2. 在门户着陆页上点击 API。
   或者，您也可以在顶部导航栏的门户下拉菜单中选择 API。
3. 将光标置于要管理受众群体的 API 上，以显示相关操作。
4. 点击 。
5. 在“受众群体”下，选择以下选项之一：
   • 匿名用户：允许所有用户查看 API 产品。
   • 注册用户：仅允许已注册的用户查看 API 产品。
6. 点击保存。

从门户中移除 API

如需从您的门户中移除 API，请执行以下操作：

1. 选择发布 > 门户，然后选择您的门户。
2. 在门户着陆页上点击 API。
   或者，您也可以在顶部导航栏的门户下拉菜单中选择 API。
3. 将光标置于列表中的 API 上以显示操作菜单。
4. 点击 。

排查已发布的 API 的问题

使用“试用”时，如果系统返回 TypeError: Failed to fetch 错误，请考虑以下可能的原因和解决方法：

• 对于混合内容错误，错误可能是由已知的 Swagger 界面问题引起。 一种可能的解决方法是确保在 OpenAPI 规范的 schemes 定义中在 HTTP 前面指定 HTTPS。例如：

   schemes:
     - https
     - http
  

• 对于 CORS（跨源资源共享）限制错误，请确保您的 API 代理支持 CORS。CORS 是一种支持客户端跨源请求的标准机制。请参阅向 API 代理添加 CORS 支持。同时，确保浏览器中已启用 CORS。