[英]WSO2 API Manager: how is “import swagger definition” expected to be used?
[英]WSO2 API import not doing anything (from Swagger)
我剛剛安裝了WSO2 2.0.0(據我所知,這是v1.9.0之后的版本,而不是破壞性的兼容性版本)。 我正在Windows上通過Firefox 40.0.2使用它。
當我嘗試通過“我有現有的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":{
(...)
}
}
似乎您要導入的swagger文檔的版本為swagger 1.2(“ swaggerVersion”:“ 1.2”)。 從API Manager 1.9開始,我們應該使用swagger 2.0兼容的定義。
您可以使用http://editor.swagger.io/#/根據2.0規范來驗證您的招搖定義。 請嘗試根據2.0規范對其進行轉換,然后導入到API Manager 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
聲明:本站的技術帖子網頁,遵循CC BY-SA 4.0協議,如果您需要轉載,請注明本站網址或者原文地址。任何問題請咨詢:yoyou2525@163.com.