问题描述
我们正在使用 Swagger/Swashbuckle 生成 OpenApi 定义。然后将此定义导入 Azure API 管理。
我们在标记为必需的获取请求上有一些查询字符串参数。我们的验证确保查询字符串参数存在且有效,否则我们将返回 400 Bad Request,其中包含哪些参数无效/缺失的详细信息。 OpenAPI 定义的相关部分如下。两个查询字符串参数(标记为必填)和一个路径参数(标记为必填)。
我的问题是 OpenApi 定义转换为 APIM 操作的方式。
所需的查询字符串参数作为模板参数添加到操作url中。这意味着如果不提供它们,APIM 无法将请求与操作匹配,我们会向调用方返回 404,而不是后端将返回的有用的 400。
我无法轻松地将空值添加到查询字符串中。我无法在操作的入站策略中执行此操作,因为它与操作不匹配。在全局入站策略中执行此操作意味着我必须自己确定操作(这只是众多操作之一)。同样,虽然我可以在 onerror 策略中返回一个 400 bad request,但我不能轻易告诉调用者这个请求出了什么问题。
我认为它已内置于导入过程中。当我将模板参数更改为门户中的查询参数并导出时,OpenApi 定义实际上是相同的。当我重新导入导出的模板时,发生了同样的事情。我也尝试过通过 Wadl,它看起来更有希望,但我无法重新导入该模板。
有没有办法将模板查询字符串参数移动为查询字符串参数?还有其他选择吗?
解决方法
目前(自 2018 年以来)Azure APIM API 导入中存在错误。 Link。
状态正在审核中。我们试图直接向微软提出这个问题,但他们没有提供任何解决方案。