您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
Apigee Edge 可为您提供存储 OpenAPI 规范的场所。管理您的 OpenAPI 规范,如以下部分所述。
如需详细了解 OpenAPI 规范,请参阅什么是 OpenAPI 规范?
浏览规范列表
如需访问规范列表,请按以下步骤操作:
- 登录 apigee.com/edge。
- 选择一个组织。
- 在侧边导航菜单中,依次选择 Develop > Specs。
此时会显示当前的规范和文件夹列表。
如上图所示,在规格列表中,您可以:
- 创建和import规范
- 使用多步骤向导根据规范生成 API 代理
- 使用文件夹整理规范,并在这些文件夹中导航(请参阅使用文件夹整理内容)
- 修改规范或通过点击相应行打开文件夹
- 重命名或删除规范
- 搜索规范和文件夹列表
创建新的 OpenAPI 规范
要创建新的 OpenAPI 规范,请执行以下操作:
- 依次点击侧边导航栏中的 Develop > Specs。
- 点击 + 规范。
- 点击下拉菜单中的 New Spec。 系统会打开规范编辑器。
- 将示例规范替换为您自己的 OpenAPI 规范详细信息。
请参阅使用规范编辑器创建规范。 - 点击保存以保存规范。
- 出现提示时,为该规范输入名称。
- 点击保存。
导入 OpenAPI 规范
要导入 OpenAPI 规范,请执行以下操作:
- 依次点击侧边导航栏中的 Develop > Specs。
- 点击 + 规范。
- 从下拉菜单中选择以下选项之一:
- 导入网址:用于从网址导入规范。出现提示时指定名称和网址。
- 导入文件以浏览本地目录以查看规范。
系统会将该规范添加到列表中。
- 点击规范名称即可在规范编辑器中进行查看和修改。
请参阅使用规范编辑器创建规范。
修改现有 OpenAPI 规范
要打开现有的 OpenAPI 规范,请执行以下操作:
- 依次点击侧边导航栏中的 Develop > Specs。
- 点击与规范列表中的规范相关联的行。
- 在规范编辑器中修改规范。
请参阅使用规范编辑器创建规范。
根据规范列表中的规范创建 API 代理
借助 Apigee Edge,您可以根据自己设计并保存在规范编辑器中的 OpenAPI 规范来创建 API 代理。只需点击几下,Apigee Edge 中就会有一个 API 代理,其中包含自动生成的路径、参数、条件流和目标端点。然后,您可以添加 OAuth 安全机制、速率限制和缓存等功能。
在根据 OpenAPI 规范创建 API 代理后,如果规范发生修改,您需要手动修改 API 代理以反映实现的更改。请参阅如果我修改了规范,会出现什么情况?。
要根据规范列表中的 OpenAPI 规范创建 API 代理,请执行以下操作:
- 在侧边导航菜单中,依次选择 Develop > Specs。
- 根据需要,导航到包含 OpenAPI 规范的文件夹。
- 将光标放在要为其创建 API 代理的 OpenAPI 规范上,以显示操作菜单。
- 点击 。
系统会打开“创建代理”向导,并使用 OpenAPI 规范中的值预填充代理详情页面,如下图所示。
- 点击下一步。
- 按照根据 OpenAPI 规范创建 API 代理中的说明,逐步完成“创建代理”向导的剩余页面。(从第 8 步开始。)
重命名规范
要重命名规范,请执行以下操作:
- 在侧边导航菜单中,依次选择 Develop > Specs。
- 根据需要,转到包含相应规范的文件夹。
- 将光标放在要重命名的规范上,以显示操作菜单。
- 点击 。
- 修改规范名称。
- 点击重命名以保存修改,或点击取消以取消修改。
将规范移至文件夹
您可以将规范整理到文件夹中,以方便管理和安全。如需将规范移动到文件夹中,请参阅使用文件夹整理规范。
删除规范
如果不再需要某个规范或该规范已失效,您可以从文件存储区中删除该规范。
要删除规范,请执行以下操作:
- 在侧边导航菜单中,依次选择 Develop > Specs。
- 将光标放在要删除的规范上,以显示操作菜单。
- 点击 。
- 点击删除,在提示框中确认删除操作。
- 删除不再需要的相关工件。