2

我们正在使用 Swagger/Swashbuckle 生成 OpenApi 定义。然后将此定义导入 Azure API 管理。

在我们标记为必需的获取请求上,我们有一些查询字符串参数。我们的验证确保查询字符串参数存在且有效,否则我们返回 400 错误请求,其中包含哪些参数无效/缺失的详细信息。OpenAPI 定义的相关部分如下。两个查询字符串参数(标记为必填)和一个路径参数(标记为必填)。

OpenAPI 定义提取

我的问题是 OpenApi 定义转换为 APIM 操作的方式。

所需的查询字符串参数作为模板参数添加,并添加到操作 url。这意味着如果未提供它们,APIM 无法将请求与操作匹配,我们会向调用者返回 404,而不是后端将返回的有用的 400。

APIM 操作模板定义

我无法轻松地将空值添加到查询字符串中。我无法在操作的入站策略中执行此操作,因为它与操作不匹配。在全局入站策略中执行此操作意味着我必须自己识别操作(这只是众多操作之一)。同样,虽然我可以在 onerror 策略中返回 400 错误请求,但我不能轻易告诉调用者该请求出了什么问题。

我认为它已内置到导入过程中。当我将模板参数更改为门户中的查询参数并导出时,OpenApi 定义实际上是相同的。当我重新导入导出的模板时,同样的事情发生了。我还尝试通过看起来更有希望的 Wadl,但我无法重新导入该模板。

有没有办法将模板查询字符串参数移动为查询字符串参数?还有其他选择吗?

4

1 回答 1

1

目前(自 2018 年以来)Azure APIM API 导入中存在错误。链接

它的状态正在审查中。我们试图直接向微软提出这个问题,但他们没有提供解决方案。

于 2021-06-18T14:49:44.007 回答