验证 OpenAPI YAML 源

在编辑 API 时,如何根据 swagger 规范验证OpenAPIYAML 源。

关于此任务

When you're configuring an API in the API editor, you can validate the OpenAPI YAML source by clicking 验证 > 附带规格. 如果找到任何 Swagger 解析器验证错误,那么将显示一个错误图标,您可以单击该图标以查看各个错误以及这些错误在 YAML 中的发生位置。 然后,您可以修复错误、保存更新,并在整个 API 配置过程中继续验证OpenAPIYAML。
注:
  • OpenAPI验证不会显示网关或策略错误,这些错误会阻止 API 的暂存或发布。 仅当您尝试编译打包或发布 API 时,才会发生此类型的验证。 有关详细信息,请参阅暂存 API发布 API
  • 您还可以使用管理规则集来验证 API 文档。 有关更多信息,请参阅使用治理服务验证 API 或产品文档

您可以使用 API Designer UI 应用程序或使用基于浏览器的 API Manager UI 来完成此任务。

过程

要验证 OpenAPI YAML 源,请完成以下步骤。

  1. 打开所需的 API 以进行编辑,如 编辑 OpenAPI 2.0 API 定义编辑 OpenAPI 3.0 API 定义中所述。
  2. 单击标题菜单栏中的验证 > 使用规范
    显示 "联机" 滑块控件, "验证" 按钮和 "保存" 按钮的标题菜单栏的截屏。
  3. 如果发现任何 Swagger 解析器验证错误,那么将在标题菜单栏上显示一个错误图标,找到的 OpenAPI 错误数显示在该图标旁边。
    例如,小的,圆形的,红色的错误图标,旁边有数字。
  4. 然后,您可以单击错误图标以查看错误及其在 YAML 中的位置的详细列表。 如果您在表单"表单图标视图中,可以单击单个错误直接导航到表单中的相关 API 部分。
  5. 修正错误后,单击 保存 以保存更新,然后再次单击 验证
  6. 修复所有错误后,验证将返回一条成功消息。
    例如,包含黑色复选标记的小绿色圆圈的截屏,旁边的单词 API 已经过验证。