Estou tentando dividir meu documento da API em vários arquivos JSON que podem ser editados independentemente. Todos os exemplos que consegui encontrar usam o esquema Swagger 1.2, que possui um objeto "api": {} para decompô-lo. Isso parece estar ausente no esquema 2.0 (http://json.schemastore.org/swagger-2.0) Tudo o que define é uma única matriz de "caminhos", na qual agrupa todos os pontos de extremidade da API nessa única matriz. O efeito disso no swagger-ui é que existe uma única categoria "padrão" na qual tudo é agrupado e de maneira nenhuma que eu possa dizer para dividi-lo.

TLDR: Como você divide operações de caminhos no esquema do 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"
            }
          }
        }
      }
    }
  }
}