Swagger UI 错误 : Unable to fetch API Listing

Question

我正在用 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"
        }
    ]
}

但即使在将原始文件上传到我的 Web 服务器之后，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 文件吗？

Answer 1

我假设您要访问 www.myserver.org 并且它会显示 swagger ui？在 Swagger UI 的“探索”文本框中...确保输入您的 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

如果您有更多问题，请随时提出。