@hubex/mcp 0.2.0

package/swagger/dev/AUTHZ.json

@@ -0,0 +1,1404 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "API авторизации HubEx",
+    "description": "Выполняет авторизацию учётной записи в тенанте, выпуск и обновление JWT, управление refresh- и service-токенами.",
+    "contact": {
+      "name": "SmartService Backend Team",
+      "email": "fmbackend@melston.ru"
+    },
+    "version": "v1.0.0.0"
+  },
+  "servers": [
+    {
+      "url": "/AUTHZ"
+    }
+  ],
+  "paths": {
+    "/AccessTokens": {
+      "post": {
+        "tags": [
+          "AccessTokens"
+        ],
+        "summary": "Обновляет access-токен по refresh-токену, одноразовому токену или сервисному токену.",
+        "description": "Поддерживает три способа аутентификации (достаточно одного):\r\n- `refreshJwt` — JWT refresh-токен;\r\n- `oneTimeLoginToken` + `tenantID` — одноразовый токен входа;\r\n- `serviceToken` — сервисный токен.\r\n            \r\nПри заголовке `X-Use-Cookie: true` refresh-токен читается из cookie `RefreshTokenCookie`; в теле достаточно пустого JSON-объекта `{}` (поле `refreshJwt` необязательно). Отсутствие тела запроса не поддерживается.\r\n            \r\nОпциональный заголовок `X-Application-ID` проверяет доступ к указанному приложению.\r\n            \r\n## Пример запроса (refresh-токен):\r\n```json\r\nPOST /AccessTokens\r\n            \r\n{\r\n  \"refreshJwt\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\r\n  \"accessJwt\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\r\n}\r\n```\r\n            \r\n## Пример запроса (X-Use-Cookie):\r\n```json\r\nPOST /AccessTokens\r\nX-Use-Cookie: true\r\n            \r\n{}\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\r\n  \"expires_in\": 3600,\r\n  \"jwtValidTill\": \"2024-06-15T10:00:00Z\",\r\n  \"profile\": { \"userID\": 42, \"firstName\": \"Иван\", \"lastName\": \"Иванов\" },\r\n  \"permissions\": {},\r\n  \"tenant\": { \"id\": 10, \"name\": \"Demo\", \"fullName\": \"Demo Tenant LLC\", \"uriName\": \"demo\" },\r\n  \"tenantMember\": { \"id\": 1001, \"userID\": 42, \"accountID\": 100 }\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — не удалось определить члена тенанта по переданным данным.\r\n- 400 Bad Request — отсутствует тело при работе без cookie, некорректный или просроченный токен.\r\n- 403 Forbidden — нет доступа к указанному приложению (заголовок `X-Application-ID`).",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Данные для обновления access-токена.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/RefreshData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RefreshData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RefreshData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/RefreshData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Access-токен успешно обновлён.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/TenantMemberAuthorizationResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TenantMemberAuthorizationResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TenantMemberAuthorizationResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Некорректные данные или токен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Член тенанта не найден."
+          },
+          "403": {
+            "description": "Нет доступа к приложению.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/Accounts/authorize": {
+      "post": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Авторизует учётную запись в указанном тенанте.",
+        "description": "Тело запроса целиком можно опустить — тогда `tenantID` и `tenantMemberID` берутся из JWT текущего пользователя.\r\nЕсли тело передано, оба поля (`tenantID`, `tenantMemberID`) обязательны и должны быть больше 0.\r\n            \r\n## Пример запроса:\r\n```json\r\nPOST /Accounts/authorize\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"tenantID\": 10,\r\n  \"tenantMemberID\": 1001\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\r\n  \"expires_in\": 3600,\r\n  \"jwtValidTill\": \"2024-06-15T10:00:00Z\",\r\n  \"profile\": {\r\n    \"userID\": 42,\r\n    \"firstName\": \"Иван\",\r\n    \"lastName\": \"Иванов\"\r\n  },\r\n  \"permissions\": { \"TaskView\": \"Allow\" },\r\n  \"tenantLicenses\": [],\r\n  \"featureFlags\": [],\r\n  \"roleTaskAttribute\": []\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 400 Bad Request — передано неполное или некорректное тело (например `{}` или только одно из полей).",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Данные для авторизации в тенанте. Не передавайте тело, чтобы использовать значения из JWT.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/AuthorizeData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AuthorizeData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AuthorizeData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/AuthorizeData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Авторизация в тенанте выполнена успешно.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/TenantMemberAuthorizationResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TenantMemberAuthorizationResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TenantMemberAuthorizationResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Некорректные данные запроса.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/RefreshTokens": {
+      "post": {
+        "tags": [
+          "RefreshTokens"
+        ],
+        "summary": "Генерирует refresh-токен для текущего члена тенанта.",
+        "description": "При заголовке `X-Use-Cookie: true` refresh-токен записывается в HttpOnly-cookie, тело ответа пустое.\r\n            \r\n## Пример запроса:\r\n```json\r\nPOST /RefreshTokens\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"validity\": \"30.00:00:00\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200/201):\r\n```json\r\n{\r\n  \"access_token\": \"\",\r\n  \"refresh_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\r\n  \"expires_in\": 2592000,\r\n  \"jwtValidTill\": \"2024-07-15T10:00:00Z\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа при X-Use-Cookie (200/201):\r\nТело ответа пустое, refresh-токен в cookie `RefreshTokenCookie`.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 400 Bad Request — некорректные параметры или ошибка настройки CORS при использовании cookie.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Параметры генерации (опционально).",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/GenerateData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GenerateData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/GenerateData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/GenerateData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Refresh-токен успешно получен (существующий).",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "Refresh-токен успешно создан.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Некорректные данные запроса.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "get": {
+        "tags": [
+          "RefreshTokens"
+        ],
+        "summary": "Возвращает refresh-токен с параметрами по умолчанию.",
+        "description": "При заголовке `X-Use-Cookie: true` refresh-токен записывается в HttpOnly-cookie, тело ответа пустое.\r\n            \r\n## Пример запроса:\r\n```text\r\nGET /RefreshTokens\r\nAuthorization: Bearer <access-token>\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"access_token\": \"\",\r\n  \"refresh_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\r\n  \"expires_in\": 2592000,\r\n  \"jwtValidTill\": \"2024-07-15T10:00:00Z\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (204):\r\nRefresh-токен не найден.\r\n            \r\n## Пример успешного ответа при X-Use-Cookie (200):\r\nТело ответа пустое, refresh-токен в cookie `RefreshTokenCookie`.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 400 Bad Request — ошибка настройки CORS при использовании cookie.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Refresh-токен успешно получен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Refresh-токен не найден."
+          },
+          "400": {
+            "description": "Некорректные параметры запроса.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/ServiceTokens": {
+      "post": {
+        "tags": [
+          "ServiceTokens"
+        ],
+        "summary": "Генерирует сервисные токены для указанных членов тенанта.",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /ServiceTokens\r\nAuthorization: Bearer <access-token>\r\n            \r\n[1001, 1002]\r\n```\r\n            \r\n## Пример успешного ответа (201):\r\n```json\r\n[\r\n  {\r\n    \"token\": \"svc_abc123def456\",\r\n    \"created\": \"2024-06-15T09:00:00Z\",\r\n    \"validTill\": \"2025-06-15T09:00:00Z\"\r\n  }\r\n]\r\n```\r\n            \r\n## Пример успешного ответа (204):\r\nТело ответа пустое — новые токены не были созданы.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав (`ServiceTokenAdd`).",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Список идентификаторов членов тенанта.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            },
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            },
+            "text/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Токены успешно созданы.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/PostResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/PostResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/PostResult"
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Новые токены не созданы."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "ServiceTokens"
+        ],
+        "summary": "Удаляет сервисные токены указанных членов тенанта.",
+        "description": "## Пример запроса:\r\n```json\r\nDELETE /ServiceTokens\r\nAuthorization: Bearer <access-token>\r\n            \r\n[1001, 1002]\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав (`ServiceTokenRemove`).",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Список идентификаторов членов тенанта.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            },
+            "application/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            },
+            "text/json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Токены успешно удалены."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/Tokens/renew": {
+      "post": {
+        "tags": [
+          "Tokens"
+        ],
+        "summary": "Продлевает срок действия текущего JWT access-токена.",
+        "description": "Токен извлекается из сохранённого Bearer-токена текущего запроса.\r\n            \r\n## Пример запроса:\r\n```text\r\nPOST /Tokens/renew\r\nAuthorization: Bearer <access-token>\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\",\r\n  \"expires_in\": 3600,\r\n  \"jwtValidTill\": \"2024-06-15T10:00:00Z\"\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 400 Bad Request — access-токен не найден в контексте аутентификации.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Токен успешно обновлён.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/JwtResultBase"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Access-токен отсутствует.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ErrorModel"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "AuthorizeData": {
+        "required": [
+          "tenantID",
+          "tenantMemberID"
+        ],
+        "type": "object",
+        "properties": {
+          "tenantID": {
+            "type": "integer",
+            "description": "ИД тенанта, в который будет авторизован пользователь.",
+            "format": "int32",
+            "example": 10
+          },
+          "tenantMemberID": {
+            "type": "integer",
+            "description": "ИД члена тенанта, в который этот член будет авторизован.",
+            "format": "int32",
+            "example": 1001
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для авторизации в тенанте. Если тело запроса передаётся, оба поля обязательны."
+      },
+      "ErrorModel": {
+        "type": "object",
+        "properties": {
+          "traceIdentifier": {
+            "type": "string",
+            "nullable": true
+          },
+          "code": {
+            "type": "string",
+            "nullable": true
+          },
+          "message": {
+            "type": "string",
+            "nullable": true
+          },
+          "arguments": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "GenerateData": {
+        "type": "object",
+        "properties": {
+          "validity": {
+            "type": "string",
+            "description": "Срок действия токена",
+            "format": "date-span",
+            "nullable": true,
+            "example": "30.00:00:00"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Параметры генерации токена"
+      },
+      "IdCodeNameResultOfShort": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "code": {
+            "type": "string",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "IdNameResultOfByte": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "JwtResultBase": {
+        "type": "object",
+        "properties": {
+          "access_token": {
+            "type": "string",
+            "description": "JWT-токен для доступа к ресурсам",
+            "nullable": true,
+            "readOnly": true,
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+          },
+          "refresh_token": {
+            "type": "string",
+            "description": "JWT-токен для обновления JWT-токена для доступа к ресурсам",
+            "nullable": true,
+            "readOnly": true,
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+          },
+          "expires_in": {
+            "type": "integer",
+            "description": "Количество секунд, через которой токен будет просрочен",
+            "format": "int32",
+            "nullable": true,
+            "readOnly": true,
+            "example": 3600
+          },
+          "jwtValidTill": {
+            "type": "string",
+            "description": "Метка времени в UTC, до которой действует JWT",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2024-06-15T10:00:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные JWT"
+      },
+      "PostResult": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "type": "string",
+            "description": "Токен",
+            "nullable": true,
+            "example": "svc_abc123def456"
+          },
+          "created": {
+            "type": "string",
+            "description": "Метка времени создания токена",
+            "format": "date-time",
+            "example": "2024-06-15T09:00:00Z"
+          },
+          "validTill": {
+            "type": "string",
+            "description": "Срок действия токена",
+            "format": "date-time",
+            "example": "2025-06-15T09:00:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Результат генерации сервисного токена"
+      },
+      "RefreshData": {
+        "type": "object",
+        "properties": {
+          "jwt": {
+            "type": "string",
+            "description": "JWT refresh-токен",
+            "nullable": true,
+            "deprecated": true
+          },
+          "refreshJwt": {
+            "type": "string",
+            "description": "JWT refresh-токен",
+            "nullable": true,
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+          },
+          "accessJwt": {
+            "type": "string",
+            "description": "JWT access-токен (опциональный, необходим для определения включены ли в access-токен какие-либо расщирения, если включены новый токен будет сгенерирован с учетогм их)",
+            "nullable": true,
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+          },
+          "oneTimeLoginToken": {
+            "type": "string",
+            "description": "Токен для одноразовой авторизации в тенанте",
+            "nullable": true,
+            "example": "one-time-token-value"
+          },
+          "tenantID": {
+            "type": "integer",
+            "description": "Идентификатор тенанта, в который будет произведен вход по HubEx.Service.AUTHZ.Api.Data.AccessToken.RefreshData.OneTimeLoginToken",
+            "format": "int32",
+            "nullable": true,
+            "example": 10
+          },
+          "serviceToken": {
+            "type": "string",
+            "description": "Сервисный токен для упрощенной авторизации",
+            "nullable": true,
+            "example": "svc_abc123def456"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Класс, принимающий JWT для обновления JWT доступа к ресурсам."
+      },
+      "TenantLicenseCurrentResult": {
+        "type": "object",
+        "properties": {
+          "license": {
+            "$ref": "#/components/schemas/IdCodeNameResultOfShort"
+          },
+          "dateTill": {
+            "type": "string",
+            "description": "Дата окончания лицензии",
+            "format": "date-time",
+            "example": "2025-12-31T23:59:59Z"
+          },
+          "isTrialPeriod": {
+            "type": "boolean",
+            "description": "Флаг пробного периода",
+            "example": false
+          },
+          "dateFrom": {
+            "type": "string",
+            "description": "Дата начала лицензии",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
+          },
+          "trialPeriodDays": {
+            "type": "integer",
+            "description": "Длина пробного периода в днях",
+            "format": "int32",
+            "nullable": true,
+            "example": 14
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные текущей лицензии тенанта"
+      },
+      "TenantMemberAuthorizationResult": {
+        "type": "object",
+        "properties": {
+          "access_token": {
+            "type": "string",
+            "description": "JWT-токен для доступа к ресурсам",
+            "nullable": true,
+            "readOnly": true,
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+          },
+          "refresh_token": {
+            "type": "string",
+            "description": "JWT-токен для обновления JWT-токена для доступа к ресурсам",
+            "nullable": true,
+            "readOnly": true,
+            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+          },
+          "expires_in": {
+            "type": "integer",
+            "description": "Количество секунд, через которой токен будет просрочен",
+            "format": "int32",
+            "nullable": true,
+            "readOnly": true,
+            "example": 3600
+          },
+          "jwtValidTill": {
+            "type": "string",
+            "description": "Метка времени в UTC, до которой действует JWT",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2024-06-15T10:00:00Z"
+          },
+          "profile": {
+            "$ref": "#/components/schemas/UserProfileResult"
+          },
+          "permissions": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "description": "Данные пользователя как члена тенанта.",
+            "nullable": true
+          },
+          "refreshToken": {
+            "$ref": "#/components/schemas/JwtResultBase"
+          },
+          "tenant": {
+            "$ref": "#/components/schemas/TenantResult"
+          },
+          "tenantMember": {
+            "$ref": "#/components/schemas/TenantMemberResult"
+          },
+          "tenantLicenses": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TenantLicenseCurrentResult"
+            },
+            "description": "Данные лицензий тенанта",
+            "nullable": true
+          },
+          "featureFlags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Список флагов нового функционала, доступных тенанту",
+            "nullable": true
+          },
+          "roleTaskAttribute": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int32"
+            },
+            "description": "Список доступных атрибутов для ролей пользователя по заявке",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Авторизация члена тенанта"
+      },
+      "TenantMemberResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Идентификатор члена тенанта",
+            "format": "int32",
+            "example": 1001
+          },
+          "description": {
+            "type": "string",
+            "description": "Описание",
+            "nullable": true,
+            "example": "Инженер участка"
+          },
+          "userID": {
+            "type": "integer",
+            "description": "Идентификатор пользователя",
+            "format": "int32",
+            "example": 42
+          },
+          "accountID": {
+            "type": "integer",
+            "description": "Идентификатор учетной записи",
+            "format": "int32",
+            "example": 100
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные члена тенанта"
+      },
+      "TenantResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Идентификатор тенанта",
+            "format": "int32",
+            "example": 10
+          },
+          "name": {
+            "type": "string",
+            "description": "Краткое название тенанта",
+            "nullable": true,
+            "example": "Demo"
+          },
+          "fullName": {
+            "type": "string",
+            "description": "Полное название тенанта",
+            "nullable": true,
+            "example": "Demo Tenant LLC"
+          },
+          "uriName": {
+            "type": "string",
+            "description": "Uri-постфикс",
+            "nullable": true,
+            "example": "demo"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные тенанта"
+      },
+      "UserProfileResult": {
+        "type": "object",
+        "properties": {
+          "userID": {
+            "type": "integer",
+            "description": "Идентификатор пользователя",
+            "format": "int32",
+            "example": 42
+          },
+          "firstName": {
+            "type": "string",
+            "description": "Имя",
+            "nullable": true,
+            "example": "Иван"
+          },
+          "lastName": {
+            "type": "string",
+            "description": "Фамилия",
+            "nullable": true,
+            "example": "Иванов"
+          },
+          "middleName": {
+            "type": "string",
+            "description": "Отчество",
+            "nullable": true
+          },
+          "email": {
+            "type": "string",
+            "description": "Адрес эл.почты",
+            "nullable": true,
+            "example": "ivan.ivanov@example.com"
+          },
+          "mobilePhone": {
+            "type": "string",
+            "description": "Мобильный телефон",
+            "nullable": true
+          },
+          "workPhone": {
+            "type": "string",
+            "description": "Рабочий телефон",
+            "nullable": true
+          },
+          "otherPhone": {
+            "type": "string",
+            "description": "Другой телефон",
+            "nullable": true
+          },
+          "avatarUrl": {
+            "type": "string",
+            "description": "Ссылка на аватар пользователя",
+            "nullable": true
+          },
+          "geoTrackingMode": {
+            "$ref": "#/components/schemas/IdNameResultOfByte"
+          },
+          "accountDomainLogin": {
+            "type": "string",
+            "description": "Domain login аккаунта пользователя",
+            "nullable": true
+          },
+          "defaultPageWeb": {
+            "type": "string",
+            "description": "Стартовая страница для WEB",
+            "nullable": true
+          },
+          "defaultPageMobile": {
+            "type": "string",
+            "description": "Стартовая страница для МП инженера",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Профиль пользователя"
+      }
+    },
+    "securitySchemes": {
+      "Bearer": {
+        "type": "http",
+        "description": "Введите токен для авторизации",
+        "scheme": "Bearer",
+        "bearerFormat": "JWT"
+      }
+    }
+  },
+  "tags": [
+    {
+      "name": "AccessTokens",
+      "description": "Контроллер для управления токенами доступа"
+    },
+    {
+      "name": "Accounts",
+      "description": "Контроллер для аутентификации и авторизации учетных записей"
+    },
+    {
+      "name": "RefreshTokens",
+      "description": "Контроллер для управления токенами обновления токена доступа"
+    },
+    {
+      "name": "ServiceTokens",
+      "description": "Контроллер для управления сервисными токенами"
+    },
+    {
+      "name": "Tokens",
+      "description": "Контроллер для работы с JWT"
+    },
+    {
+      "name": "AccessTokens",
+      "description": "Контроллер для управления токенами доступа"
+    },
+    {
+      "name": "Accounts",
+      "description": "Контроллер для аутентификации и авторизации учетных записей"
+    },
+    {
+      "name": "RefreshTokens",
+      "description": "Контроллер для управления токенами обновления токена доступа"
+    },
+    {
+      "name": "ServiceTokens",
+      "description": "Контроллер для управления сервисными токенами"
+    },
+    {
+      "name": "Tokens",
+      "description": "Контроллер для работы с JWT"
+    }
+  ]
+}