使用规范编辑器创建规范
您正在查看的是 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 规范而不保存所做修改,请点击顶部导航栏中的取消。您将返回到规范列表。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-02-07。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-02-07\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-02-07。"]]