我正在使用Swagger记录REST Web API。我已经下载了petstore示例。它由resources.json
引用pet.json
和user.json
:
{
"apiVersion":"0.2",
"swaggerVersion":"1.0",
"basePath":"http://petstore.swagger.wordnik.com/api",
"apis":
[
{
"path":"/pet.{format}",
"description":"Operations about pets"
},
{
"path":"/user.{format}",
"description":"Operations about user"
}
]
}
但即使将原始文件上传到我的网络服务器后,Swagger UI也会告诉我:
Unable to fetch API Listing. Tried the following urls:
http://www.myserver.org/resources.json
http://www.myserver.org
http://www.myserver.org/resources.json
http://www.myserver.org/resources
你能说出是什么原因导致Swagger找不到我的json文件吗?
答案 0 :(得分:4)
我假设你要去www.myserver.org并且它带来了招摇的ui?在Swagger UI的“Explore”文本框中...确保输入resources.json的位置。
我个人用这种方式设置了swagger api文档......
http://adamclerk.com/api --Swagger UI
http://adamclerk.com/api/doc --returns json representing resources.js
http://adamclerk.com/api/doc/donuts --returns json representing donut operations
您可以在此处查看更详细的解释 - Swagger With Static Documentation
如果您有任何其他问题,请随时提出。