将.Net Core API导入和部署到Azure API管理

Question

我一直在尝试创建.Net Core API并将其发布到Azure。我按照this示例创建了API。创建API后，我按照this示例将其发布到Azure。我能够成功调用该API。我正在尝试将此API导入我的API管理中，但是我一直收到错误消息

  

一个或多个字段包含不正确的值：解析错误：错误   从JsonReader读取JObject。当前的JsonReader项目不是   对象：StartArray。路径”，第1行，位置1。

我在这里错过了什么吗？既然我已经将API发布为天蓝色，为什么我需要将其导入并发布到我的API管理中？

这是azure api管理中错误消息的屏幕截图：

Answer 1

如果在导入OpenAPI文档时遇到错误，请确保您已对其进行验证-使用Azure门户（设计-前端-OpenAPI规范编辑器）中的设计器，或使用第三个-方工具，例如Swagger Editor。

·仅支持OpenAPI的JSON格式。

·路径和查询中必需的参数必须具有唯一的名称。 （在OpenAPI中，参数名称仅在一个位置（例如，路径，查询，标头）中必须是唯一的。但是，在API管理中，我们允许通过路径和查询参数（OpenAPI不支持）来区分操作。因此，我们需要参数名称在整个URL模板中是唯一的。）

·使用$ ref属性引用的架构不能包含其他$ ref属性。

· $ ref 指针无法引用外部文件。

· x-ms-paths 和 x-servers 是唯一受支持的扩展。

·自定义扩展名在导入时将被忽略，并且不会保存或保留用于导出。

有关更多详细信息，您可以参考此article。