Как разбить файл JSON swagger 2.0 на несколько модулей

Я пытаюсь разбить свой документ API на несколько файлов JSON, которые можно редактировать независимо. Все примеры, которые мне удалось найти, используют схему Swagger 1.2, в которой есть объект «api»: {} для его разбивки. Похоже, что отсутствует в схеме 2.0 (http://json.schemastore.org/swagger-2.0). Все, что определяет, - это один массив «путей», в котором он объединяет все конечные точки API в этот единственный массив. Эффект этого в Swagger-UI заключается в том, что существует одна категория «по умолчанию», в которую все включено, и я никак не могу сказать, чтобы разделить ее.

TLDR: как вы разделяете операции по путям в схеме Swagger 2.0

{
  "swagger": "2.0",
  "info": {
    "description": "My API",
    "version": "1.0.0",
    "title": "My API",
    "termsOfService": "http://www.domain.com",
    "contact": {
      "name": "[email protected]"
    }
  },
  "basePath": "/",
  "schemes": [
    "http"
  ],
  "paths": {
    "Authorization/LoginAPI": {
      "post": {
        "summary": "Authenticates you to the system and produces a session token that will be used for future calls",
        "description": "",
        "operationId": "LoginAPI",
        "consumes": [
          "application/x-www-form-urlencoded"
        ],
        "produces": [
          "application/json"
        ],
        "parameters": [{
          "in": "formData",
          "name": "UserName",
          "description": "Login Username",
          "required": true,
          "type": "string"

        }, {
          "in": "formData",
          "name": "Password",
          "description": "Password",
          "required": true,
          "type": "string"

        }],
        "responses": {
          "200": {
            "description": "API Response with session ID if login is allowed",
            "schema": {
              "$ref": "#/definitions/Authorization"
            }
          }
        }
      }
    }
  }
}

Ответы на вопрос(7)

Ваш ответ на вопрос