带有source2swagger的静态API文档

Question

source2swagger在一个json文件中生成所有apis的swagger规范。 swagger-ui实际上可以使用它吗？当我用swagger-ui浏览生成的json文件时，它会尝试从spec中的路径中读取api描述，而不是在单个json文件中使用描述/操作。

Answer 1

Swagger-UI将处理所有的json在一个文件中。我不确定是否可以有多个顶级资源列表。

这里有一个工作示例：

{"basePath":"http://localhost:3001/", "resourcePath":"/", "swaggerVersion":"1.1", "apiVersion":"1.0", "apis":[ 
    { 
     "path":"/pay", 
     "format":"json", 
     "description":"Create a transaction with the given amount and token.", 
     "operations":[ 
      { 
       "httpMethod":"GET", 
       "tags":["production"], 
       "nickname":"pay", 
       "deprecated":false, 
       "summary":"Create a transaction with the given amount and token.", 
       "parameters":[ 
        { 
         "name":"token", 
         "description":"The token representing the pay card", 
         "dataType":"string", 
         "allowMultiple":false, 
         "required":true, 
         "paramType":"query" 
        }, 
        { 
         "name":"amount", 
         "description":"The amount to pay", 
         "dataType":"string", 
         "allowMultiple":false, 
         "required":true, 
         "paramType":"query" 
        } 
       ] 
      } 
     ] 
    }, 
    { 
     "path":"/customer", 
     "format":"json", 
     "description":"Create an HTML form for adding a customer.", 
     "operations":[ 
      { 
       "httpMethod":"GET", 
       "tags":["production"], 
       "nickname":"createCustomerForm", 
       "deprecated":false, 
       "summary":"Create an HTML form for adding a customer.", 
       "parameters":[ 
        { 
         "name":"customerId", 
         "description":"Your customer id", 
         "dataType":"string", 
         "allowMultiple":false, 
         "required":true, 
         "paramType":"query" 
        } 
       ] 
      } 
     ] 
    }, 
    { 
     "path":"/customer/{customerId}", 
     "format":"json", 
     "description":"Delete the customer info for given id.", 
     "operations":[ 
      { 
       "httpMethod":"DELETE", 
       "tags":["production"], 
       "nickname":"deleteCustomer", 
       "deprecated":false, 
       "summary":"Delete the customer info for given id.", 
       "parameters":[ 
        { 
         "name":"customerId", 
         "description":"the customer id to delete", 
         "dataType":"string", 
         "allowMultiple":false, 
         "required":true, 
         "paramType":"path" 
        } 
       ] 
      } 
     ] 
    }, 
    { 
     "path":"/card", 
     "format":"json", 
     "description":"Create an HTML form for adding a credit card.", 
     "operations":[ 
      { 
       "httpMethod":"GET", 
       "tags":["production"], 
       "nickname":"createCardForm", 
       "deprecated":false, 
       "summary":"Create an HTML form for the given customer to add a credit card.", 
       "parameters":[ 
        { 
         "name":"customerId", 
         "description":"Your customer id", 
         "dataType":"string", 
         "allowMultiple":false, 
         "required":true, 
         "paramType":"query" 
        } 
       ] 
      } 
     ] 
    }, 
    { 
     "path":"/card/{token}", 
     "format":"json", 
     "description":"Delete a card record by token.", 
     "operations":[ 
      { 
       "httpMethod":"DELETE", 
       "tags":["production"], 
       "nickname":"deleteCard", 
       "deprecated":false, 
       "summary":"Delete the card info for given token.", 
       "parameters":[ 
        { 
         "name":"token", 
         "description":"the token to delete", 
         "dataType":"string", 
         "allowMultiple":false, 
         "required":true, 
         "paramType":"path" 
        } 
       ] 
      } 
     ] 
    } 
]}