caspar-chen / swagger-ui-layer

基于swagger的漂亮的接口文档
Apache License 2.0
532 stars 232 forks source link

不使用注解,使用编辑json的方式可以使用这个ui吗? #22

Open Lyndon1994 opened 6 years ago

caspar-chen commented 6 years ago

在doc.js文件中第20行 url : "v2/api-docs" 将url改成对应的json文件地址就可以了。

Lyndon1994 commented 6 years ago

谢谢,但是遇到一个问题,我自己用swagger editor写的json可以在原生的swagger ui上显示出来,但是用swagger-ui-layer就只能显示侧边栏,也不报错,不知道啥原因,有debug功能嘛?

{
  "swagger": "2.0",
  "info": {
    "description": "platform OpenAPI",
    "version": "1.0.0",
    "title": "SDK"
  },
  "host": "test.com",
  "basePath": "/rest/2.0/cambrian",
  "tags": [
    {
      "name": "user", 
      "description": "用户管理" 
    }
  ],
  "schemes": [
    "http"  
  ],
  "paths": {
    "/user/info": {
      "post": {
        "tags": [
          "user"  
        ],      
        "summary": "aaaaa",
        "produces": [
          "application/json"
        ],      
        "parameters": [
          {       
            "name": "access_token",
            "in": "query",
            "required": true,
            "description": "aaa",
            "type": "string"
          },      
          {       
            "name": "user_list",
            "in": "body", 
            "required": true,
            "description": "aaaa", 
            "schema": {
              "type": "object",
              "properties": {
                "user_list": {
                  "type": "array",
                  "items": {
                    "required": [
                      "openid"
                    ],
                    "properties": {
                      "openid": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "aaaa",
            "schema": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}