您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
使用规范编辑器创建和验证 OpenAPI 规范,而无需编写任何代码。
访问规范编辑器
如以下部分所述,在规范编辑器中打开 OpenAPI 规范:
下图显示了在规范编辑器中打开的 Petstore API 的规范:
如上图所示,规范编辑器允许您执行以下操作:
- 创建 OpenAPI 规范,以便在左侧窗格中使用 JSON 或 YAML 格式对 API 进行建模。
- 在右侧窗格中查看自动生成的 API 文档。
- 在输入过程中,根据 OpenAPI 规范标准验证您的规范。
- 保存您的 OpenAPI 规范,或关闭该规范并取消您的修改。
帮我使用 JSON 和 YAML
JSON(JavaScript 对象表示法)是一种轻量级数据交换格式,用于表示简单的数据结构和关联数组。如需了解详情,请参阅 https://www.json.org。
YAML(YAML 不是标记语言)是一种数据序列化/表示标准,提供的语法还提供了可映射到数据结构(例如列表、关联数组和标量)的语法。如需了解详情,请参阅 https://yaml.org。
JSON 和 YAML 均可读取,但也易于人类阅读和理解。下图比较了使用 JSON 和 YAML 编写的同一 OpenAPI 规范的两个简短摘录:
验证规范
规范编辑器会根据 OpenAPI 规范标准验证您的 OpenAPI 规范。在您输入时,如果 OpenAPI 规范中存在错误,规范编辑器会在右侧窗格顶部显示“错误”对话框,并提供有关错误及其相关行号的更多信息,以便您轻松纠正这些错误。
保存规范
如需保存 OpenAPI 规范,请点击顶部导航栏中的 Save。
如果这是您第一次保存规范,系统会提示您输入文件名。如果您不指定文件名,则默认为“Untitled”(无标题)。您可以稍后重命名。
关闭规范
要关闭 OpenAPI 规范而不保存所做修改,请点击顶部导航栏中的取消。您将返回到规范列表。