您正在查看的是 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 规范而不保存所做修改，请点击顶部导航栏中的取消。您将返回到规范列表。