{"openapi":"3.0.3","info":{"title":"Периметр API","version":"1.2.0","description":"Рабочий API цифровой эксплуатации. Сначала войдите в приложение или откройте демо в соседней вкладке на этом же адресе. Swagger отправляет вашу сессию автоматически. Для внешнего клиента используйте Authorize и Bearer API-ключ. Ключи read только читают данные. Изменяющие запросы действительно сохраняют данные вашей организации."},"servers":[{"url":"/"}],"security":[{"sessionCookie":[]},{"apiKey":[]}],"tags":[{"name":"Авторизация"},{"name":"Объекты"},{"name":"Оборудование"},{"name":"Заявки"},{"name":"Обходы"},{"name":"Документы"},{"name":"Обучение"},{"name":"Телеметрия"},{"name":"Профиль"},{"name":"Доступ"},{"name":"Система"},{"name":"Команда"},{"name":"IFC"},{"name":"ТО"}],"paths":{"/api/objects":{"get":{"summary":"Список записей","tags":["Объекты"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Object"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Создать запись","tags":["Объекты"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"},"example":{"name":"Корпус B","type":"Офис","area":1200}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Object"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/objects/{id}":{"get":{"summary":"Прочитать запись","tags":["Объекты"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Object"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"Изменить запись","tags":["Объекты"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Название"},"type":{"type":"string","enum":["Офис","Завод","ЦОД","Склад"]},"address":{"type":"string","description":"Адрес"},"manager":{"type":"string","description":"Ответственный"},"area":{"type":"number","minimum":0}}},"example":{"name":"Обновлённое название"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Object"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/assets":{"get":{"summary":"Список записей","tags":["Оборудование"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Создать запись","tags":["Оборудование"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"},"example":{"name":"Насос P-01","code":"P-01","objectId":"obj-1","status":"normal"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/assets/{id}":{"get":{"summary":"Прочитать запись","tags":["Оборудование"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"Изменить запись","tags":["Оборудование"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"Название"},"code":{"type":"string","description":"Уникальный код"},"objectId":{"type":"string","description":"ID объекта"},"system":{"type":"string","description":"Система"},"location":{"type":"string","description":"Расположение"},"status":{"type":"string","enum":["normal","attention","offline"]},"nextService":{"type":"string","description":"Плановое ТО","format":"date"},"documentId":{"type":"string","description":"ID документа или пустая строка"},"ifcGlobalId":{"type":"string","description":"GlobalId элемента IFC или пустая строка","maxLength":22}}},"example":{"name":"Обновлённое название"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Asset"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/tickets":{"get":{"summary":"Список записей","tags":["Заявки"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Ticket"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Создать запись","tags":["Заявки"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Ticket"},"example":{"title":"Проверка фильтра","assetId":"asset-1","priority":"medium","status":"new"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ticket"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/tickets/{id}":{"get":{"summary":"Прочитать запись","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ticket"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"Изменить запись","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"title":{"type":"string","description":"Работа"},"assetId":{"type":"string","description":"ID актива"},"priority":{"type":"string","enum":["low","medium","high"]},"status":{"type":"string","enum":["new","progress","done"]},"assignee":{"type":"string","description":"Исполнитель"},"due":{"type":"string","description":"Срок","format":"date"},"description":{"type":"string","description":"Описание","maxLength":5000},"ifcContext":{"$ref":"#/components/schemas/IfcView","description":"Место, ракурс, срезы и выбранный элемент модели"}}},"example":{"status":"done"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Ticket"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/documents":{"get":{"summary":"Список записей","tags":["Документы"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/Document"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Создать запись","tags":["Документы"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"},"example":{"title":"Учебный регламент","content":"Текст учебного документа","revision":"1.0","assetId":"asset-1"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Document"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/documents/{id}":{"get":{"summary":"Прочитать запись","tags":["Документы"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Document"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"Изменить запись","tags":["Документы"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"title":{"type":"string","description":"Название"},"content":{"type":"string","description":"Текст","maxLength":200000},"revision":{"type":"string","description":"Версия"},"category":{"type":"string","description":"Категория"},"assetId":{"type":"string","description":"ID актива или пустая строка"}}},"example":{"name":"Обновлённое название"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Document"},{"type":"object","properties":{"id":{"type":"string","description":"ID записи"}}}]}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/auth/demo":{"post":{"summary":"Создать отдельное демопространство","tags":["Авторизация"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"ФИО"},"email":{"type":"string","description":"Email","format":"email"},"password":{"type":"string","description":"Пароль","format":"password","minLength":10,"maxLength":128}}},"example":{}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/auth/register":{"post":{"summary":"Зарегистрироваться","tags":["Авторизация"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"ФИО"},"email":{"type":"string","description":"Email","format":"email"},"password":{"type":"string","description":"Пароль","format":"password","minLength":10,"maxLength":128}}},"example":{"name":"Инженер","email":"engineer@example.test","password":"Example-password-2026"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/auth/login":{"post":{"summary":"Войти","tags":["Авторизация"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"ФИО"},"email":{"type":"string","description":"Email","format":"email"},"password":{"type":"string","description":"Пароль","format":"password","minLength":10,"maxLength":128}}},"example":{"email":"engineer@example.test","password":"Example-password-2026"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/auth/logout":{"post":{"summary":"Выйти","tags":["Авторизация"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"ФИО"},"email":{"type":"string","description":"Email","format":"email"},"password":{"type":"string","description":"Пароль","format":"password","minLength":10,"maxLength":128}}},"example":{}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/health":{"get":{"summary":"Доступность сервера","tags":["Система"],"security":[],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/me":{"get":{"summary":"Пользователь","tags":["Система"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/state":{"get":{"summary":"Рабочее пространство","tags":["Система"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/audit":{"get":{"summary":"Журнал действий","tags":["Система"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/knowledge":{"get":{"summary":"Поиск с источниками","tags":["Документы"],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"example":"фильтр"}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/inspections":{"post":{"summary":"Завершить обход","tags":["Обходы"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["assetId","checklistId","answers"],"properties":{"assetId":{"type":"string","description":"ID актива"},"checklistId":{"type":"string","description":"ID шаблона"},"answers":{"type":"array","minItems":5,"maxItems":5,"items":{"type":"string","enum":["ok","issue","na"]}},"note":{"type":"string","description":"Замечания"}}},"example":{"assetId":"asset-1","checklistId":"check-1","answers":["ok","ok","ok","ok","ok"],"note":"Учебный обход"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/training":{"post":{"summary":"Сохранить ответы тренировки","tags":["Обучение"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["scenario","answers"],"properties":{"scenario":{"type":"string","enum":["ahu-alarm"]},"answers":{"type":"array","minItems":4,"maxItems":4,"items":{"type":"integer","minimum":0,"maximum":2}}}},"example":{"scenario":"ahu-alarm","answers":[1,0,2,1]}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/telemetry":{"post":{"summary":"Принять показание мощности","tags":["Телеметрия"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["assetId","metric","value"],"properties":{"assetId":{"type":"string","description":"ID актива"},"metric":{"type":"string","enum":["power_kw"]},"value":{"type":"number","minimum":0,"maximum":10000000}}},"example":{"assetId":"asset-1","metric":"power_kw","value":42.5}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/demo/telemetry":{"post":{"summary":"Создать учебное показание","tags":["Телеметрия"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["assetId"],"properties":{"assetId":{"type":"string","description":"ID актива"}}},"example":{"assetId":"asset-1"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/keys":{"get":{"summary":"Список ключей без секретов","tags":["Доступ"],"security":[{"sessionCookie":[]}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Создать API-ключ, секрет показывается один раз","tags":["Доступ"],"security":[{"sessionCookie":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["label"],"properties":{"label":{"type":"string","description":"Название"},"scope":{"type":"string","enum":["read","write"]}}},"example":{"label":"Тестовый адаптер","scope":"read"}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/keys/{id}":{"delete":{"summary":"Отозвать ключ","tags":["Доступ"],"security":[{"sessionCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/profile":{"get":{"summary":"Карточка сотрудника","tags":["Профиль"],"security":[{"sessionCookie":[]}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"Обновить профиль сотрудника","tags":["Профиль"],"security":[{"sessionCookie":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Profile"},"example":{"name":"Алексей Иванов","position":"Инженер эксплуатации","phone":"+7 900 000-00-00","employeeNumber":"EMP-001"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/profile/qr.svg":{"get":{"summary":"QR-код сотрудника, не пропуск и не ключ авторизации","tags":["Профиль"],"security":[{"sessionCookie":[]}],"responses":{"200":{"description":"QR в SVG","content":{"image/svg+xml":{"schema":{"type":"string"}}}}}}},"/api/settings":{"patch":{"summary":"Название пространства","tags":["Система"],"security":[{"sessionCookie":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Название организации"}}},"example":{"name":"Моя организация"}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/export/assets":{"get":{"summary":"Экспорт реестра","tags":["Оборудование"],"responses":{"200":{"description":"CSV UTF-8","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/api/auth/accept-invite":{"post":{"summary":"Принять одноразовое приглашение","tags":["Команда"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token","name","password"],"properties":{"token":{"type":"string","description":"Токен из ссылки"},"name":{"type":"string","description":"Имя"},"password":{"type":"string","description":"Пароль 10–128 символов"}}}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/team":{"get":{"summary":"Сотрудники и ожидающие приглашения","tags":["Команда"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/team/{id}":{"patch":{"summary":"Изменить роль или активность (администратор)","tags":["Команда"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"enum":["admin","engineer","observer"],"type":"string"},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/invitations":{"post":{"summary":"Пригласить сотрудника (администратор)","tags":["Команда"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","role"],"properties":{"email":{"type":"string","description":"Email сотрудника"},"role":{"type":"string","enum":["admin","engineer","observer"]}}}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/invitations/{id}":{"delete":{"summary":"Отозвать приглашение","tags":["Команда"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/ifc-views":{"get":{"summary":"Сохранённые виды модели","tags":["IFC"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Сохранить ракурс и срезы модели","tags":["IFC"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","view"],"properties":{"name":{"type":"string","description":"Название"},"view":{"$ref":"#/components/schemas/IfcView"},"assetId":{"type":"string","description":"Связанный актив"},"ticketId":{"type":"string","description":"Связанная заявка"}}}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/ifc-views/{id}":{"get":{"summary":"Прочитать сохранённый вид","tags":["IFC"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"summary":"Удалить сохранённый вид","tags":["IFC"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/tickets/{id}/comments":{"get":{"summary":"Комментарии заявки","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Добавить комментарий","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Комментарий","maxLength":5000}}}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/tickets/{id}/photos":{"get":{"summary":"Фотографии заявки","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Добавить фото (до 5 МиБ, максимум 5 на заявку)","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"name":{"type":"string","description":"Имя файла"},"data":{"type":"string","description":"Base64 JPEG/PNG/WebP без data-префикса"}}}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/tickets/{id}/photos/{photoId}":{"get":{"summary":"Получить фотографию","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"photoId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Изображение","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"summary":"Удалить фотографию","tags":["Заявки"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"photoId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/maintenance":{"get":{"summary":"Планы обслуживания","tags":["ТО"],"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Создать план, автоматически сформировать наступившую работу","tags":["ТО"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","assetId","nextDue","intervalDays","active"],"properties":{"title":{"type":"string","description":"Работа"},"assetId":{"type":"string","description":"Оборудование"},"nextDue":{"type":"string","description":"Следующий срок","format":"date"},"intervalDays":{"type":"integer","minimum":0,"maximum":3650},"active":{"type":"boolean"},"assignee":{"type":"string","description":"Исполнитель"},"priority":{"type":"string","enum":["low","medium","high"]},"description":{"type":"string","description":"Инструкция"}}}}}},"responses":{"201":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/maintenance/{id}":{"patch":{"summary":"Изменить или приостановить план","tags":["ТО"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"nextDue":{"type":"string","description":"Дата","format":"date"},"active":{"type":"boolean"},"intervalDays":{"type":"integer","minimum":0,"maximum":3650}}}}}},"responses":{"200":{"description":"Успешно","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Нет авторизации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Недостаточно прав","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Проверьте поля","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string","description":"Сообщение ошибки"}}},"Object":{"type":"object","required":["name","type"],"properties":{"name":{"type":"string","description":"Название"},"type":{"type":"string","enum":["Офис","Завод","ЦОД","Склад"]},"address":{"type":"string","description":"Адрес"},"manager":{"type":"string","description":"Ответственный"},"area":{"type":"number","minimum":0}}},"Asset":{"type":"object","required":["name","code","objectId"],"properties":{"name":{"type":"string","description":"Название"},"code":{"type":"string","description":"Уникальный код"},"objectId":{"type":"string","description":"ID объекта"},"system":{"type":"string","description":"Система"},"location":{"type":"string","description":"Расположение"},"status":{"type":"string","enum":["normal","attention","offline"]},"nextService":{"type":"string","description":"Плановое ТО","format":"date"},"documentId":{"type":"string","description":"ID документа или пустая строка"},"ifcGlobalId":{"type":"string","description":"GlobalId элемента IFC или пустая строка","maxLength":22}}},"Ticket":{"type":"object","required":["title","assetId"],"properties":{"title":{"type":"string","description":"Работа"},"assetId":{"type":"string","description":"ID актива"},"priority":{"type":"string","enum":["low","medium","high"]},"status":{"type":"string","enum":["new","progress","done"]},"assignee":{"type":"string","description":"Исполнитель"},"due":{"type":"string","description":"Срок","format":"date"},"description":{"type":"string","description":"Описание","maxLength":5000},"ifcContext":{"$ref":"#/components/schemas/IfcView","description":"Место, ракурс, срезы и выбранный элемент модели"}}},"Document":{"type":"object","required":["title","content"],"properties":{"title":{"type":"string","description":"Название"},"content":{"type":"string","description":"Текст","maxLength":200000},"revision":{"type":"string","description":"Версия"},"category":{"type":"string","description":"Категория"},"assetId":{"type":"string","description":"ID актива или пустая строка"}}},"Profile":{"type":"object","properties":{"name":{"type":"string","description":"ФИО","maxLength":80},"position":{"type":"string","description":"Должность","maxLength":120},"phone":{"type":"string","description":"Телефон","maxLength":40},"employeeNumber":{"type":"string","description":"Табельный номер","maxLength":40}}},"IfcView":{"type":"object","required":["model","camera","target","cuts"],"properties":{"model":{"type":"string","description":"SHA-256 файла IFC","pattern":"^[a-f0-9]{64}$"},"camera":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number"}},"target":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number"}},"cuts":{"type":"object","description":"enabled, box, x/y/z (0–100), xMin/yMin/zMin, xReverse/yReverse/zReverse"},"selected":{"type":"integer","nullable":true},"point":{"type":"array","nullable":true,"items":{"type":"number"},"minItems":3,"maxItems":3},"hidden":{"type":"array","items":{"type":"integer"}},"only":{"type":"array","items":{"type":"integer"}},"floor":{"type":"string","description":"Этаж IFC"},"system":{"type":"string","description":"Система IFC или реестра"},"issuesOnly":{"type":"boolean"}}}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API-ключ вида prm_..."},"sessionCookie":{"type":"apiKey","in":"cookie","name":"perimetr_session","description":"Используется текущая браузерная сессия. Войдите в приложение, вручную вводить cookie не нужно."}}}}