WSO2 API import 什么都不做（来自 Swagger）

Question

我刚刚安装了WSO2 2.0.0（据我所知，这是v1.9.0之后的版本，不是破坏兼容性的版本）。我在 Windows.

上通过 Firefox 40.0.2 使用它

当我尝试通过 "I have an existing API" 菜单添加新的 API 时，无论我做什么，它总是打开一个空的设计 API 屏幕：https://localhost:9443/publisher/design

在此屏幕中，当我尝试导入一个 API（swagger 文件或 swagger URL）时，它什么也没做，没有提示任何错误。我的 swagger 文件遵循 Swagger API 2.0 规范并对应于已在生产中使用的 API。

我应该怎么做才能至少获得一条关于此 API 导入的有用错误消息？（如果它正在安装其他版本的 WSO2，这对我来说是一个有效的答案。）

这是我尝试导入的 Swagger 文件：

    {
   "apiVersion":"2.0",
   "swaggerVersion":"1.2",
   "basePath":"/ValoConso/rest",
   "resourcePath":"/valoConsoWebService",
   "apis":[
      {
         "path":"/valoConsoElec",
         "operations":[
            {
               "method":"POST",
               (...)
            }
         ]
      }
   ],
   "models":{
      (...)
   }
}

Answer 1

您尝试导入的 swagger 文档似乎是 swagger 版本 1.2 ("swaggerVersion":"1.2")。从 API Manager 1.9 开始，我们应该使用 swagger 2.0 兼容定义。

您可以使用 http://editor.swagger.io/#/ 根据 2.0 规范验证您的 swagger 定义。请尝试按2.0规范转换后再导入APIManager 2.0.

查看一些有用的资源：

[1] Swagger 2.0 样本：https://github.com/OAI/OpenAPI-Specification/tree/master/examples/v2.0/json

[2] Swagger 1.2 -> 2.0 迁移指南：https://github.com/OAI/OpenAPI-Specification/wiki/swagger-1.2-to-2.0-migration-guide

WSO2 API import 什么都不做（来自 Swagger）

WSO2 API import not doing anything (from Swagger)

api

wso2

swagger

wso2-am