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

时间:2018-08-23 09:57:29

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

我想就我面临的一个问题向您寻求帮助。因此,基本上,我为API定义了swagger 2.0规范,并且在操作的响应中,我使用了schema属性,以便引用一些反映响应结构的对象的定义。我在Swagger编辑器上验证了该规范,它是有效的,并且如果我使用Swagger Codegen生成客户端代码,则该客户端应用程序可以很好地使用API​​。现在,问题是。我去了开发者门户,在API的详细信息页面上,检查了API定义(“打开API”选项),并将该规范与我以前用来在API Management服务上导入API的原始规范进行了比较。而且我注意到缺少schema属性,因此它没有引用响应的schema。有想法吗?

谢谢

1 个答案:

答案 0 :(得分:3)

我发现了问题。显然,根据Swagger 2.0规范,在响应上使用schema属性,可以使用嵌套的$ refs,以便互相引用定义。但是显然,Azure API管理服务是不可能的,因为以下链接中提到它是一个限制:API Management - API Import restrictions

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

谢谢