Estoy tratando de dividir mi documento API en múltiples archivos JSON que se pueden editar de forma independiente. Todos los ejemplos que he podido encontrar utilizan el esquema Swagger 1.2 que tiene un objeto "api": {} para descomponerlo. Parece que falta en el esquema 2.0 (http://json.schemastore.org/swagger-2.0) Todo lo que define es una matriz única de "rutas" donde agrupa todos los puntos finales API en esa matriz única. El efecto de esto en la swagger-ui es que hay una sola categoría "predeterminada" en la que todo se agrupa y de ninguna manera puedo decir que lo divida.

TLDR: ¿Cómo se dividen las operaciones de las rutas en el esquema 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"
            }
          }
        }
      }
    }
  }
}