Azure API 管理 - 使用 Swagger 2.0 规范导入 API - 不考虑响应的架构 属性
Azure API Management - Import API using Swagger 2.0 spec - schema property on the responses is not considered
我想就我面临的一个问题请求您的帮助。所以基本上我为 API 定义了一个 swagger 2.0 规范,并且在操作的响应中我使用了模式 属性 来引用反映响应结构的对象的一些定义。我在 Swagger Editor 上验证了规范,它是有效的,而且如果我使用 Swagger Codegen 生成客户端代码,客户端应用程序在使用 API 时运行良好。现在,问题是。我访问了开发人员门户并在 API 的详细信息页面上检查了 API 定义(打开 API 选项)并将该规范与我以前使用的原始规范进行了比较在 API 管理服务上导入 API。我注意到模式 属性 丢失了,所以它没有引用响应的模式。有什么想法吗?
谢谢
我想通了这个问题。根据 Swagger 2.0 规范,显然在响应中使用模式 属性,您可以使用嵌套的 $refs,以便在彼此内部引用定义。但显然,Azure API 管理服务是不可能的,因为它在以下 link 中作为限制被提及:API Management - API Import restrictions.
无论如何,我会尝试更改我的 API 规范以避免嵌套 $refs 并解决问题。
谢谢
我想就我面临的一个问题请求您的帮助。所以基本上我为 API 定义了一个 swagger 2.0 规范,并且在操作的响应中我使用了模式 属性 来引用反映响应结构的对象的一些定义。我在 Swagger Editor 上验证了规范,它是有效的,而且如果我使用 Swagger Codegen 生成客户端代码,客户端应用程序在使用 API 时运行良好。现在,问题是。我访问了开发人员门户并在 API 的详细信息页面上检查了 API 定义(打开 API 选项)并将该规范与我以前使用的原始规范进行了比较在 API 管理服务上导入 API。我注意到模式 属性 丢失了,所以它没有引用响应的模式。有什么想法吗?
谢谢
我想通了这个问题。根据 Swagger 2.0 规范,显然在响应中使用模式 属性,您可以使用嵌套的 $refs,以便在彼此内部引用定义。但显然,Azure API 管理服务是不可能的,因为它在以下 link 中作为限制被提及:API Management - API Import restrictions.
无论如何,我会尝试更改我的 API 规范以避免嵌套 $refs 并解决问题。
谢谢