Azure API 管理 - 使用 Swagger 2.0 规范导入 API - 不考虑响应的架构属性答案

【问题标题】：Azure API Management - Import API using Swagger 2.0 spec - schema property on the responses is not consideredAzure API 管理 - 使用 Swagger 2.0 规范导入 API - 不考虑响应的架构属性
【发布时间】：2018-08-23 09:57:28
【问题描述】：

我想就我面临的一个问题寻求您的帮助。所以基本上我为 API 定义了一个 swagger 2.0 规范，并且在操作的响应上，我使用了 schema 属性来引用反映响应结构的对象的一些定义。我在 Swagger 编辑器上验证了规范，它是有效的，而且如果我使用 Swagger Codegen 生成客户端代码，客户端应用程序在使用 API 时运行良好。现在，问题来了。我去了 Developer Portal 并在 API 的详细信息页面上检查了 API 定义（开放 API 选项），并将规范与我用来在 API 管理服务上导入 API 的原始规范进行了比较。我注意到模式属性丢失了，所以它没有引用响应的模式。有什么想法吗？

谢谢

【问题讨论】：

标签： azure swagger-2.0 azure-api-management openapi

【解决方案1】：

我发现了这个问题。根据 Swagger 2.0 规范，显然在响应上使用 schema 属性，您可以使用嵌套的 $refs，以便在彼此内部引用定义。但显然，Azure API 管理服务不可能，因为它在以下链接中被提及为限制：API Management - API Import restrictions。

无论如何，我会尝试更改我的 API 规范以避免嵌套 $refs 并解决该问题。

谢谢

【讨论】：