【问题标题】:how to specify multiple basepath in swagger-ui in nodejs app如何在nodejs应用程序的swagger-ui中指定多个基本路径
【发布时间】:2019-08-22 10:13:47
【问题描述】:

我有一个 Node.js 服务器在端口 8080 上运行。我正在使用 swagger,它允许设置基本路径。我想为不同的端点设置多个基本路径。我正在使用 swagger-ui-express 来服务器 swagger ui 文件。

我浏览了 swagger 的文档并尝试使用服务器属性,但它不起作用。我的端点是:

  1. 端点:/users/movies
    应担任:http://localhost:9090/cinema-mgr-api/users/movies
  2. 端点:/aws-mgr-api/storage
    应担任:http://localhost:9090/aws-mgr-api/storage

如何使用swagger-ui-express 定义多个基本路径?

【问题讨论】:

标签: node.js swagger-ui endpoint


【解决方案1】:

下面的代码是我的项目。我使用了swagger-tools依赖,版本是0.10.4

swagger.json

{
    "swagger": "2.0",
    "info": {
        "title": "Node JS APP",
        "description": "Node JS APP",
        "version": "1.0.0"
    },
    "produces": [
        "application/json"
    ],
    "host": "localhost:9000",
    "basePath": "/api",
    "paths": {
        "/cinema-mgr-api/users/movies":{
            "post": {
                "tags": ["controller"],
                "description": "movies",
                "x-swagger-router-controller": "controller",
                "operationId": "movies",
                "parameters": [
                    {
                        "name": "body",
                        "in": "body",
                        "description": "movies",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/movies"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "search successful"
                    }
                }
            }
        },
        "/aws-mgr-api/storage": {
            "post": {
                "tags": ["aws-controller"],
                "description": "storage",
                "x-swagger-router-controller": "aws-controller",
                "operationId": "storage",
                "parameters": [
                    {
                        "name": "body",
                        "in": "body",
                        "required": true,
                        "schema": {
                            "$ref": "#/definitions/storage"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "stored Successfully"
                    }
                }
            }
        }
    },
    "definitions": {
        "movies": {
            "type": "object",
            "required": [
                "movieName"
            ],
            "properties": {
                "movieId": {
                    "type": "string"
                },
                "movieName": {
                    "type": "string"
                },
                "filters": {
                    "type": "object",
                    "properties": {
                        "period": {
                            "type": "string"
                        },
                        "year": {
                            "type": "array"
                        },
                        "language": {
                            "type": "array"
                        }
                    }
                }
            }
        },
        "storage": {
            "type":"object"
        }
    }
}

【讨论】:

    猜你喜欢
    • 1970-01-01
    • 2014-03-05
    • 2018-01-07
    • 2018-09-20
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多