@hubex/mcp 0.2.0

package/swagger/dev/AUTH.json

@@ -0,0 +1,1739 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "Authenticatin and authorization API for HubEx",
+    "description": "Performs all of the operations, necessary to authenticate and authorize a user as a valid tenant member. Offers an API for registering, verifying e-mail, changing password, etc.",
+    "contact": {
+      "name": "SmartService Backend Team",
+      "email": "fmbackend@melston.ru"
+    },
+    "version": "v1.0.0.0"
+  },
+  "servers": [
+    {
+      "url": "/AUTH"
+    }
+  ],
+  "paths": {
+    "/Accounts/this/applications": {
+      "get": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Приложения учетной записи",
+        "description": "Поддерживает ограничение результата через заголовок `Range`.\r\n            \r\n## Пример запроса:\r\n```text\r\nGET /Accounts/this/applications\r\nAuthorization: Bearer <access-token>\r\nRange: Offset=0; Fetch=25\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n[\r\n  {\r\n    \"client\": {\r\n      \"id\": 1,\r\n      \"uniqueClientIdentifier\": \"abc-123-def-456\",\r\n      \"agent\": \"Android 14\",\r\n      \"clientType\": { \"id\": 1, \"name\": \"Mobile\" }\r\n    },\r\n    \"application\": {\r\n      \"id\": 2,\r\n      \"name\": \"HubEx Mobile\",\r\n      \"version\": \"3.5.0\"\r\n    },\r\n    \"pushToken\": \"fcm-token-xyz\",\r\n    \"timestamp\": \"2026-08-21T08:00:00Z\"\r\n  }\r\n]\r\n```\r\n            \r\n## Пример успешного ответа (206):\r\nТело ответа имеет тот же формат, что и для `200`, но содержит только часть диапазона. Заголовок `Content-Range` указывает общее количество.\r\n            \r\n## Негативные сценарии:\r\n- 204 NoContent: приложения не найдены.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `AccountClientApplicationList`.",
+        "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": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApplicationListResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApplicationListResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApplicationListResult"
+                  }
+                }
+              }
+            }
+          },
+          "206": {
+            "description": "Возвращена часть списка в пределах запрошенного диапазона.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApplicationListResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApplicationListResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApplicationListResult"
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Приложения не найдены."
+          },
+          "401": {
+            "description": "Отсутствует или некорректен Bearer-токен."
+          },
+          "403": {
+            "description": "Недостаточно прав для просмотра приложений."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "put": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Актуализация данных о приложениях текущей учетной записи",
+        "description": "## Пример запроса:\r\n```json\r\nPUT /Accounts/this/applications\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"clientTypeID\": 1,\r\n  \"agent\": \"Android 14\",\r\n  \"applicationVersion\": \"3.5.0\",\r\n  \"pushToken\": \"fcm-token-xyz\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized: отсутствует идентификатор учётной записи и участника тенанта в токене.",
+        "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/AUTHACAMergeData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AUTHACAMergeData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AUTHACAMergeData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/AUTHACAMergeData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Данные приложения приняты к обработке."
+          },
+          "401": {
+            "description": "Не удалось определить учётную запись из токена."
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Отвязка приложения и устройства от текущей учетной записи",
+        "description": "## Пример запроса:\r\n```json\r\nDELETE /Accounts/this/applications\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"uniqueClientIdentifier\": \"abc-123-def-456\",\r\n  \"applicationID\": 2\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized: отсутствует идентификатор учётной записи и участника тенанта в токене.",
+        "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/AUTHACARemoveData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AUTHACARemoveData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AUTHACARemoveData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/AUTHACARemoveData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Запрос на отвязку принят."
+          },
+          "401": {
+            "description": "Не удалось определить учётную запись из токена."
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/Accounts/logout": {
+      "post": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Выход из системы. Метод можно вызывать с просроченным токеном.",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /Accounts/logout\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"uniqueClientIdentifier\": \"abc-123-def-456\",\r\n  \"applicationID\": 2\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized: токен не содержит идентификатор учётной записи или участника тенанта.\r\n- 409 Conflict: отсутствует или некорректен заголовок Authorization, либо тело запроса не указано.",
+        "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/BaseLogoutData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BaseLogoutData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/BaseLogoutData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/BaseLogoutData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Выход выполнен успешно."
+          },
+          "401": {
+            "description": "Не удалось определить учётную запись или участника тенанта из токена."
+          },
+          "409": {
+            "description": "Некорректный Authorization или тело запроса."
+          }
+        }
+      }
+    },
+    "/Accounts/register": {
+      "post": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Создаёт аккаунт с указанной электронной почтой (если ещё не создан),\r\nблокирует его по причине непройденной верификации почты и отправляет\r\nнотификацию для отправки письма или SMS со ссылкой для верификации.",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /Accounts/register\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"email\": \"user%40example.com\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200) — существующая учётная запись:\r\n```json\r\n{\r\n  \"id\": 1001,\r\n  \"verificationRequestValidTill\": \"2026-08-21T12:00:00Z\",\r\n  \"isEmailVerified\": false,\r\n  \"isMobilePhoneVerified\": false,\r\n  \"isPasswordDefined\": false,\r\n  \"isNewAccount\": false\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202) — новая учётная запись (email или SMS):\r\n```json\r\n{\r\n  \"id\": 1001,\r\n  \"verificationRequestValidTill\": \"2026-08-21T12:00:00Z\",\r\n  \"isEmailVerified\": false,\r\n  \"isMobilePhoneVerified\": false,\r\n  \"isPasswordDefined\": false,\r\n  \"isNewAccount\": true\r\n}\r\n```\r\nОтправляется уведомление для верификации (письмо или SMS).\r\n            \r\n## Пример успешного ответа (202) — новая учётная запись (domainLogin):\r\nТело ответа аналогично примеру выше с `\"isNewAccount\": true`. Уведомление **не отправляется**.\r\n            \r\n## Негативные сценарии:\r\n- 409 Conflict: тело запроса не указано, ошибки валидации, не указаны email/телефон/domainLogin или указаны некорректные данные.",
+        "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/CreateData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Учётная запись уже существует.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountAddResultEntity"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountAddResultEntity"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountAddResultEntity"
+                }
+              }
+            }
+          },
+          "202": {
+            "description": "Новая учётная запись создана. Для email/SMS отправлено уведомление; для domainLogin уведомление не отправляется.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountAddResultEntity"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountAddResultEntity"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AccountAddResultEntity"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Тело запроса не указано, ошибки валидации или некорректные входные данные."
+          }
+        }
+      }
+    },
+    "/Accounts": {
+      "get": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Возвращает данные учетной записи по учетным данным",
+        "description": "## Пример запроса:\r\n`GET /Accounts?credential=user@example.com`\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"id\": 1001,\r\n  \"credential\": \"user@example.com\",\r\n  \"ban\": {\r\n    \"dateTill\": \"2026-08-22T00:00:00Z\",\r\n    \"banReason\": { \"id\": 1, \"name\": \"Email not verified\" }\r\n  },\r\n  \"isAnonymous\": false,\r\n  \"isCrossTenantAdmin\": false,\r\n  \"domainLogin\": null,\r\n  \"socialProfiles\": [\r\n    {\r\n      \"id\": 1,\r\n      \"name\": \"Google\",\r\n      \"dateFrom\": \"2025-01-01T00:00:00Z\",\r\n      \"dateTill\": \"2099-12-31T23:59:59Z\"\r\n    }\r\n  ]\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 204 NoContent: учётная запись по указанным credential не найдена.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `AccountGet`.",
+        "parameters": [
+          {
+            "name": "credential",
+            "in": "query",
+            "description": "Адрес эл.почты, телефон, логин или логин домена для аккаунта.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "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/GetResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetResult"
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Учётная запись не найдена."
+          },
+          "401": {
+            "description": "Отсутствует или некорректен Bearer-токен."
+          },
+          "403": {
+            "description": "Недостаточно прав для просмотра учётной записи."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "head": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Проверяет присутствие учетной записи по указанным полномочиям",
+        "description": "## Пример запроса:\r\n`HEAD /Accounts?credential=user@example.com`\r\n            \r\n## Пример успешного ответа (200):\r\nТело ответа пустое. Заголовок `Content-Range` не используется.\r\n            \r\n## Негативные сценарии:\r\n- 409 Conflict: параметр `credential` не указан.\r\n- 404 Not Found: учётная запись не найдена или не прошла верификацию (кроме случая `NotVerifiedException`, который возвращает 200).",
+        "parameters": [
+          {
+            "name": "credential",
+            "in": "query",
+            "description": "Адрес эл.почты, телефон или логин.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "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": "Учётная запись существует или ожидает верификации."
+          },
+          "409": {
+            "description": "Параметр credential не указан."
+          },
+          "404": {
+            "description": "Учётная запись не найдена."
+          }
+        }
+      }
+    },
+    "/Accounts/this/notifications": {
+      "get": {
+        "tags": [
+          "Accounts"
+        ],
+        "summary": "Список уведомлений из лога",
+        "description": "Поддерживает ограничение результата через заголовок `Range`.\r\n            \r\n## Пример запроса:\r\n```text\r\nGET /Accounts/this/notifications\r\nAuthorization: Bearer <access-token>\r\nRange: Offset=0; Fetch=25\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n[\r\n  {\r\n    \"notificationID\": 501,\r\n    \"providerID\": 1,\r\n    \"subject\": \"Подтверждение адреса электронной почты\",\r\n    \"content\": \"Для подтверждения перейдите по ссылке...\",\r\n    \"sent\": \"2026-08-21T08:01:00Z\"\r\n  }\r\n]\r\n```\r\n            \r\n## Пример успешного ответа (206):\r\nТело ответа имеет тот же формат, что и для `200`, но содержит только часть диапазона. Заголовок `Content-Range` указывает общее количество.\r\n            \r\n## Негативные сценарии:\r\n- 204 NoContent: уведомления не найдены.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `NotificationLogList`.",
+        "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": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              }
+            }
+          },
+          "206": {
+            "description": "Возвращена часть списка в пределах запрошенного диапазона.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Уведомления не найдены."
+          },
+          "401": {
+            "description": "Отсутствует или некорректен Bearer-токен."
+          },
+          "403": {
+            "description": "Недостаточно прав для просмотра лога уведомлений."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/Messages/verifyEmail": {
+      "post": {
+        "tags": [
+          "Messages"
+        ],
+        "summary": "Отправляет письмо проверки почты на указанный адрес эл. почты (если не был указан, то на адрес уч.записи)",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /Messages/verifyEmail\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"email\": \"user%40example.com\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\n```json\r\n{\r\n  \"id\": 1001,\r\n  \"isEmailVerified\": false,\r\n  \"isPhoneVerified\": false,\r\n  \"verificationRequestValidTill\": \"2026-08-21T12:00:00Z\",\r\n  \"isPasswordDefined\": false,\r\n  \"isNewAccount\": false,\r\n  \"verificationCodeRepeatTimeout\": 60\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized: не указан идентификатор учётной записи (ни в токене, ни в теле запроса).\r\n- 204 NoContent: учётная запись не найдена.\r\n- 409 Conflict: указан некорректный адрес электронной почты.",
+        "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/VerifyEmailData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyEmailData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyEmailData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyEmailData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Письмо верификации отправлено.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Не указан идентификатор учётной записи."
+          },
+          "204": {
+            "description": "Учётная запись не найдена."
+          },
+          "409": {
+            "description": "Некорректный адрес электронной почты."
+          }
+        }
+      }
+    },
+    "/Messages/verifyPhone": {
+      "post": {
+        "tags": [
+          "Messages"
+        ],
+        "summary": "Отправляет SMS проверки номера телефона на указанный телефон (если не был указан, то на телефон учетной записи)",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /Messages/verifyPhone\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"phone\": \"+79001234567\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\n```json\r\n{\r\n  \"id\": 1001,\r\n  \"isEmailVerified\": false,\r\n  \"isPhoneVerified\": false,\r\n  \"verificationRequestValidTill\": \"2026-08-21T12:00:00Z\",\r\n  \"isPasswordDefined\": false,\r\n  \"isNewAccount\": false,\r\n  \"verificationCodeRepeatTimeout\": 60\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized: не указан идентификатор учётной записи (ни в токене, ни в теле запроса).\r\n- 204 NoContent: учётная запись не найдена.\r\n- 409 Conflict: указан некорректный номер телефона.",
+        "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": "Данные для отправки SMS верификации.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyPhoneData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyPhoneData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyPhoneData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyPhoneData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "SMS верификации отправлено.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Не указан идентификатор учётной записи."
+          },
+          "204": {
+            "description": "Учётная запись не найдена."
+          },
+          "409": {
+            "description": "Некорректный номер телефона."
+          }
+        }
+      }
+    },
+    "/Messages/requestPasswordChange": {
+      "post": {
+        "tags": [
+          "Messages"
+        ],
+        "summary": "Отправляет запрос на изменение пароля на указанный адрес эл. почты; для аутентифицированного пользователя — на адрес эл. почты уч.записи",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /Messages/requestPasswordChange\r\n            \r\n{\r\n  \"credentials\": \"user%40example.com\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\n```json\r\n{\r\n  \"id\": 1001,\r\n  \"isEmailVerified\": true,\r\n  \"isPhoneVerified\": false,\r\n  \"verificationRequestValidTill\": \"2026-08-21T12:00:00Z\",\r\n  \"isPasswordDefined\": true,\r\n  \"isNewAccount\": false,\r\n  \"verificationCodeRepeatTimeout\": 60\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized: учётная запись не найдена.\r\n- 409 Conflict: указаны некорректные credentials или восстановление недоступно для указанного типа учётных данных.",
+        "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/RequestPasswordChangeData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestPasswordChangeData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestPasswordChangeData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestPasswordChangeData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Запрос на смену пароля отправлен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/VerificationResult"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Учётная запись не найдена."
+          },
+          "409": {
+            "description": "Некорректные credentials или недоступный способ восстановления."
+          }
+        }
+      }
+    },
+    "/Passwords/change": {
+      "post": {
+        "tags": [
+          "Passwords"
+        ],
+        "summary": "Изменяет пароль учётной записи.",
+        "description": "## Пример запроса (по SMS-коду):\r\n```json\r\nPOST /Passwords/change\r\n            \r\n{\r\n  \"password\": \"MyNewP%40ssw0rd\",\r\n  \"code\": \"123456\",\r\n  \"mobilePhone\": \"+79001234567\"\r\n}\r\n```\r\n            \r\n## Пример запроса (по текущему паролю):\r\n```json\r\nPOST /Passwords/change\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"password\": \"MyNewP%40ssw0rd\",\r\n  \"currentPassword\": \"OldP%40ssw0rd\"\r\n}\r\n```\r\n            \r\n## Пример запроса (по хэшу из e-mail):\r\n```json\r\nPOST /Passwords/change\r\n            \r\n{\r\n  \"password\": \"MyNewP%40ssw0rd\",\r\n  \"codeHash\": \"a1b2c3d4e5f6\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 403 Forbidden: указан `currentPassword`, но пользователь не аутентифицирован.\r\n- 409 Conflict: неверный текущий пароль или некорректный верификационный код.",
+        "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/PasswordSetData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PasswordSetData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PasswordSetData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/PasswordSetData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "Пароль успешно изменён."
+          },
+          "403": {
+            "description": "Смена по текущему паролю без аутентификации запрещена."
+          },
+          "409": {
+            "description": "Конфликт при проверке пароля или верификационного кода."
+          }
+        }
+      }
+    },
+    "/VerificationCodes/check": {
+      "post": {
+        "tags": [
+          "VerificationCodes"
+        ],
+        "summary": "Проверяет верификационный код.",
+        "description": "Заголовок `Authorization` **не обязателен**. Для проверки по SMS достаточно тела запроса с `code` и `mobilePhone`.\r\n            \r\n## Пример запроса (по хэшу из e-mail):\r\n```json\r\nPOST /VerificationCodes/check\r\n            \r\n{\r\n  \"codeHash\": \"a1b2c3d4e5f6\"\r\n}\r\n```\r\n            \r\n## Пример запроса (по SMS-коду):\r\n```json\r\nPOST /VerificationCodes/check\r\n            \r\n{\r\n  \"code\": \"123456\",\r\n  \"mobilePhone\": \"+79001234567\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"accountID\": 1001,\r\n  \"oneTimeLoginToken\": \"olt-abc123xyz\",\r\n  \"verificationCodeRepeatTimeout\": 60\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 409 Conflict: тело запроса не указано, ошибки валидации, верификационный код не найден или недействителен.",
+        "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": "Объект, содержащий хэш верификационного кода или код из SMS.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/CheckData"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CheckData"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CheckData"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/CheckData"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Верификационный код подтверждён.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/CheckResult"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CheckResult"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CheckResult"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Верификационный код недействителен или входные данные некорректны."
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "AUTHACAMergeData": {
+        "required": [
+          "applicationID",
+          "clientTypeID",
+          "uniqueClientIdentifier"
+        ],
+        "type": "object",
+        "properties": {
+          "uniqueClientIdentifier": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "applicationID": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "clientTypeID": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "agent": {
+            "type": "string",
+            "nullable": true
+          },
+          "applicationVersion": {
+            "type": "string",
+            "nullable": true
+          },
+          "pushToken": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "AUTHACARemoveData": {
+        "required": [
+          "applicationID",
+          "uniqueClientIdentifier"
+        ],
+        "type": "object",
+        "properties": {
+          "uniqueClientIdentifier": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "applicationID": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "additionalProperties": false
+      },
+      "AccountAddResultEntity": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "verificationRequestValidTill": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "isEmailVerified": {
+            "type": "boolean"
+          },
+          "isMobilePhoneVerified": {
+            "type": "boolean"
+          },
+          "isPasswordDefined": {
+            "type": "boolean"
+          },
+          "isNewAccount": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
+      "ApplicationListResult": {
+        "type": "object",
+        "properties": {
+          "client": {
+            "$ref": "#/components/schemas/ClientResult"
+          },
+          "application": {
+            "$ref": "#/components/schemas/ApplicationResult"
+          },
+          "pushToken": {
+            "type": "string",
+            "description": "Токен push-уведомлений",
+            "nullable": true,
+            "example": "fcm-token-xyz"
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "Метка времени актуальности данных",
+            "format": "date-time",
+            "example": "2026-08-21T08:00:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Приложение учетной записи"
+      },
+      "ApplicationResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "version": {
+            "type": "string",
+            "description": "Версия",
+            "nullable": true,
+            "example": "3.5.0"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные приложения"
+      },
+      "BanResult": {
+        "type": "object",
+        "properties": {
+          "dateTill": {
+            "type": "string",
+            "description": "Срок действия бана",
+            "format": "date-time",
+            "example": "2026-08-22T00:00:00Z"
+          },
+          "banReason": {
+            "$ref": "#/components/schemas/IdNameResultOfByte"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные блокировки пользователя"
+      },
+      "BaseLogoutData": {
+        "required": [
+          "applicationID",
+          "uniqueClientIdentifier"
+        ],
+        "type": "object",
+        "properties": {
+          "uniqueClientIdentifier": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "applicationID": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        "additionalProperties": false
+      },
+      "CheckData": {
+        "type": "object",
+        "properties": {
+          "codeHash": {
+            "type": "string",
+            "description": "Хэш верификационного кода. Отправляется по элетронной почте. Если поле заполнено, все остольные поля будут проигнорированы.",
+            "nullable": true,
+            "example": "a1b2c3d4e5f6"
+          },
+          "code": {
+            "type": "string",
+            "description": "Верификационный код из SMS.",
+            "nullable": true,
+            "example": "123456"
+          },
+          "mobilePhone": {
+            "type": "string",
+            "description": "Номер мобильного телефона, на котрый был отправлен код подтверждения.",
+            "nullable": true,
+            "example": "+79001234567"
+          },
+          "email": {
+            "type": "string",
+            "description": "Адрес электронной почты, на который был отправлен код подтверждения.",
+            "nullable": true,
+            "example": "user@example.com"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для валидации верификационного кода"
+      },
+      "CheckResult": {
+        "type": "object",
+        "properties": {
+          "accountID": {
+            "type": "integer",
+            "description": "Идентификатор учетной записи",
+            "format": "int32",
+            "example": 1001
+          },
+          "oneTimeLoginToken": {
+            "type": "string",
+            "description": "Токен для единоразовой авторизации в тенанте",
+            "nullable": true,
+            "example": "olt-abc123xyz"
+          },
+          "verificationCodeRepeatTimeout": {
+            "type": "integer",
+            "description": "Количество секунд через сколько можно повторить запрос на верификацию",
+            "format": "int32",
+            "example": 60
+          }
+        },
+        "additionalProperties": false,
+        "description": "Результат проверки верификационного кода"
+      },
+      "ClientResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Идентификатор",
+            "format": "int32",
+            "example": 1
+          },
+          "uniqueClientIdentifier": {
+            "type": "string",
+            "description": "UniqueClientIdentifier",
+            "nullable": true,
+            "example": "abc-123-def-456"
+          },
+          "agent": {
+            "type": "string",
+            "description": "Операционная система",
+            "nullable": true,
+            "example": "Android 14"
+          },
+          "clientType": {
+            "$ref": "#/components/schemas/IdNameResultOfByte"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные устройства"
+      },
+      "CreateData": {
+        "type": "object",
+        "properties": {
+          "email": {
+            "type": "string",
+            "description": "Адрес эл.почты (UrlEncoded)",
+            "nullable": true,
+            "example": "user%40example.com"
+          },
+          "mobilePhone": {
+            "type": "string",
+            "description": "Номер мобильного телефона",
+            "nullable": true,
+            "example": "+79001234567"
+          },
+          "domainLogin": {
+            "type": "string",
+            "description": "Логин домена аккаунта пользователя",
+            "nullable": true,
+            "example": "DOMAIN\\user"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Базовые данные"
+      },
+      "GetResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Идентификатор учетной записи",
+            "format": "int32",
+            "example": 1001
+          },
+          "credential": {
+            "type": "string",
+            "description": "Учетные данные",
+            "nullable": true,
+            "example": "user@example.com"
+          },
+          "ban": {
+            "$ref": "#/components/schemas/BanResult"
+          },
+          "isAnonymous": {
+            "type": "boolean",
+            "description": "Признак, указывающий на то, что под данной учетной запись имеется возможность входа без указания пароля",
+            "example": false
+          },
+          "isCrossTenantAdmin": {
+            "type": "boolean",
+            "description": "Признак, указывающий на то, что учетная запись используется для администирования тенантов",
+            "example": false
+          },
+          "domainLogin": {
+            "type": "string",
+            "description": "Логин домена аккаунта пользователя",
+            "nullable": true,
+            "example": "DOMAIN\\user"
+          },
+          "socialProfiles": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SocialProfileResult"
+            },
+            "description": "Связь с социальными профилями",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Результат поиска учетной записи"
+      },
+      "IdNameResultOfByte": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
+      "ListResult": {
+        "type": "object",
+        "properties": {
+          "notificationID": {
+            "type": "integer",
+            "description": "дентификатор уведомления",
+            "format": "int32",
+            "example": 501
+          },
+          "providerID": {
+            "type": "integer",
+            "description": "Идентификатор метода отсылки уведомления",
+            "format": "int32",
+            "example": 1
+          },
+          "subject": {
+            "type": "string",
+            "description": "Тема уведомления",
+            "nullable": true,
+            "example": "Подтверждение адреса электронной почты"
+          },
+          "content": {
+            "type": "string",
+            "description": "Содержимое уведомления",
+            "nullable": true,
+            "example": "Для подтверждения перейдите по ссылке..."
+          },
+          "created": {
+            "type": "string",
+            "description": "Дата и время создания уведомления",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2026-08-21T08:00:00Z"
+          },
+          "sent": {
+            "type": "string",
+            "description": "Дата и время отправки уведомления",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2026-08-21T08:01:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Записи из лога уведомлений"
+      },
+      "PasswordSetData": {
+        "required": [
+          "password"
+        ],
+        "type": "object",
+        "properties": {
+          "codeHash": {
+            "type": "string",
+            "description": "Хэш верификационного кода. Отправляется по элетронной почте. Если поле заполнено, все остольные поля будут проигнорированы.",
+            "nullable": true,
+            "example": "a1b2c3d4e5f6"
+          },
+          "code": {
+            "type": "string",
+            "description": "Верификационный код из SMS.",
+            "nullable": true,
+            "example": "123456"
+          },
+          "mobilePhone": {
+            "type": "string",
+            "description": "Номер мобильного телефона, на котрый был отправлен код подтверждения.",
+            "nullable": true,
+            "example": "+79001234567"
+          },
+          "email": {
+            "type": "string",
+            "description": "Адрес электронной почты, на который был отправлен код подтверждения.",
+            "nullable": true,
+            "example": "user@example.com"
+          },
+          "password": {
+            "minLength": 1,
+            "type": "string",
+            "description": "Новый пароль (UrlEncoded)",
+            "example": "MyNewP%40ssw0rd"
+          },
+          "currentPassword": {
+            "type": "string",
+            "description": "Текущий пароль пользователя (для смены пароля без верификации через SMS или Email)",
+            "nullable": true,
+            "example": "OldP%40ssw0rd"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные дял смены пароля"
+      },
+      "RequestPasswordChangeData": {
+        "required": [
+          "credentials"
+        ],
+        "type": "object",
+        "properties": {
+          "credentials": {
+            "minLength": 1,
+            "type": "string",
+            "description": "Адрес эл.почты, номер телефона или логин, для которых необходима смена пароля (UriEncoded)",
+            "example": "user%40example.com"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для смены пароля"
+      },
+      "SocialProfileResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "dateFrom": {
+            "type": "string",
+            "description": "Дата начала использования соц.сети для аутентификации",
+            "format": "date-time",
+            "example": "2025-01-01T00:00:00Z"
+          },
+          "dateTill": {
+            "type": "string",
+            "description": "Дата окончания использования соц.сети для аутентификации",
+            "format": "date-time",
+            "example": "2099-12-31T23:59:59Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные социального профиля"
+      },
+      "VerificationResult": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Идентификатор уч.записи",
+            "format": "int32",
+            "example": 1001
+          },
+          "isEmailVerified": {
+            "type": "boolean",
+            "description": "Признак пройденной проверки адреса эл.почты",
+            "example": false
+          },
+          "isPhoneVerified": {
+            "type": "boolean",
+            "description": "Признак пройденной проверки телефона",
+            "example": false
+          },
+          "verificationRequestValidTill": {
+            "type": "string",
+            "description": "Срок действия запроса на верификацию",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2026-08-21T12:00:00Z"
+          },
+          "isPasswordDefined": {
+            "type": "boolean",
+            "description": "Признак наличия пароля",
+            "example": false
+          },
+          "isNewAccount": {
+            "type": "boolean",
+            "description": "Признак новой уч.записи",
+            "example": true
+          },
+          "verificationCodeRepeatTimeout": {
+            "type": "integer",
+            "description": "Количество секунд через сколько можно повторить запрос на верификацию",
+            "format": "int32",
+            "example": 60
+          }
+        },
+        "additionalProperties": false,
+        "description": "Результат проверки"
+      },
+      "VerifyEmailData": {
+        "type": "object",
+        "properties": {
+          "accountID": {
+            "type": "integer",
+            "description": "Идентификатор уч.записи, которя запросила провекру почты (указывается только для неаутентифицированного пользователя)",
+            "format": "int32",
+            "nullable": true,
+            "example": 1001
+          },
+          "email": {
+            "type": "string",
+            "description": "Адрес эл.почты, который необходимо верифицировать (если не указан, то будет проверен основной адрес уч.записи)",
+            "nullable": true,
+            "example": "user%40example.com"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для проверки эл.почты"
+      },
+      "VerifyPhoneData": {
+        "type": "object",
+        "properties": {
+          "accountID": {
+            "type": "integer",
+            "description": "Идентификатор уч.записи, которя запросила провекру телефона (указывается только для неаутентифицированного пользователя)",
+            "format": "int32",
+            "nullable": true,
+            "example": 1001
+          },
+          "phone": {
+            "type": "string",
+            "description": "Телефон, который необходимо верифицировать (если не указан, то будет проверен основной телефон уч.записи)",
+            "nullable": true,
+            "example": "+79001234567"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для проверки эл.почты"
+      }
+    },
+    "securitySchemes": {
+      "Bearer": {
+        "type": "http",
+        "description": "Введите токен для авторизации",
+        "scheme": "Bearer",
+        "bearerFormat": "JWT"
+      }
+    }
+  },
+  "tags": [
+    {
+      "name": "Accounts",
+      "description": "Контроллер для аутентификации и авторизации учетных записей"
+    },
+    {
+      "name": "Messages",
+      "description": "Контроллер управления сообщениями"
+    },
+    {
+      "name": "Passwords",
+      "description": "Контроллер управления паролями"
+    },
+    {
+      "name": "VerificationCodes",
+      "description": "Контроллер управления прговерочными кодами"
+    },
+    {
+      "name": "Accounts",
+      "description": "Контроллер для аутентификации и авторизации учетных записей"
+    },
+    {
+      "name": "Messages",
+      "description": "Контроллер управления сообщениями"
+    },
+    {
+      "name": "Passwords",
+      "description": "Контроллер управления паролями"
+    },
+    {
+      "name": "VerificationCodes",
+      "description": "Контроллер управления прговерочными кодами"
+    }
+  ]
+}