Ich versuche, mein API-Dokument in mehrere JSON-Dateien aufzuteilen, die unabhängig voneinander bearbeitet werden können. Alle Beispiele, die ich gefunden habe, verwenden das Swagger 1.2-Schema, das ein "api": {} -Objekt zum Zerlegen enthält. Das scheint im 2.0-Schema zu fehlen http: //json.schemastore.org/swagger-2.). Alles, was definiert wird, ist ein einzelnes "Pfade" -Array, in dem alle API-Endpunkte in diesem einzelnen Array gebündelt werden. Dies hat zur Folge, dass es in der Swagger-UI eine einzige "Standard" -Kategorie gibt, in der alles gebündelt wird, und ich kann nicht sagen, wie ich es aufteilen soll.

TLDR: Wie teilt man Operationen von Pfaden im swagger 2.0-Schema auf?

{
  "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"
            }
          }
        }
      }
    }
  }
}