Версия: 8.1

API - Отчеты

Внимание

Для выполнения запроса к API необходима дополнительная авторизация.

Используйте в запросе заголовок Authorization: Bearer <персональный токен>.

Где получить персональный токен?

Шаблоны отчетов

Получение списка доступных пользователю шаблонов

GET /api/public/sm/v2/reports/templates

Параметры запроса

Название параметра	Тип параметра	Описание параметра
page	number	Номер страницы
perPage	number	Количество записей на одну страницу. Если -1 - будут возвращены все шаблоны
search	string/null	Строка поиска
sortCol	string/null	Название поля, по которому выполняется сортировка
sortDir	string/null	Направление сортировки (asc/desc)
skip	number	Количество записей, которое требуется пропустить

Пример выходной модели

[
    {
        "id": 744,
        "name": "TestReportMulti",
        "description": null,
        "type": "availability-multi",
        "workGroup": {
            "id": 490,
            "name": "DIAD"
        },
        "reportCount": 1,
        "lastReport": {
            "id": "5dd2c63e-60c0-49af-8fde-dfac8d7784b7",
            "name": "12.03.2024 17:16 TestReportMulti",
            "description": "11.03.2024 00:00 - 12.03.2024 00:00",
            "error": null,
            "status": "Ok",
            "entityInfo": {
                "createdAt": "2024-03-12T14:16:41.193456+00:00",
                "createdBy": 90206,
                "createdByName": "Getmanov Andrey",
                "updatedAt": null,
                "updatedBy": -1,
                "updatedByName": null
            }
        }
    },
    {
        "id": 40,
        "name": "DIAD-1",
        "description": null,
        "type": "availability-single",
        "workGroup": {
            "id": 490,
            "name": "DIAD"
        },
        "reportCount": 2,
        "lastReport": {
            "id": "b9cd13db-e51f-45f1-965d-c61208bfb881",
            "name": "12.03.2024 17:16 DIAD-1",
            "description": "12.03.2024 00:00 - 12.03.2024 17:16",
            "error": null,
            "status": "Ok",
            "entityInfo": {
                "createdAt": "2024-03-12T14:16:14.280912+00:00",
                "createdBy": 90206,
                "createdByName": "Getmanov Andrey",
                "updatedAt": null,
                "updatedBy": -1,
                "updatedByName": null
            }
        }
    }
]

Атрибуты выходной модели шаблона

Атрибут	Тип	Описание
id	long	Идентификатор шаблона
name	string	Название шаблона
description	string	Описание шаблона
type	string	Тип шаблона
workGroup	object	Модель рабочей группы, которой принадлежит шаблон
reportCount	integer	Количество отчетов
lastReport	object	Модель с информацией по последнему рассчитанному шаблону

Коды ответа

Код	Описание
200	Запрос успешно исполнен
401	Пользователь не авторизован
500	Непредвиденная ошибка при обработке запроса

Получение статуса отчета по идентификатору

GET /api/public/sm/v2/reports/{reportId}

Параметры запроса

Параметр	Тип	Описание
reportId	string	Идентификатор отчета

Пример выходной модели

{
  "id": "71a45161-97af-4c0f-a59f-ae0146f3a46c",
  "name": "13.03.2024 11:09 DIAD TestReportMulti",
  "description": "12.03.2024 00:00 - 13.03.2024 00:00",
  "error": null,
  "status": "Ok",
  "entityInfo": {
      "createdAt": "2024-03-13T08:09:46.115926+00:00",
      "createdBy": 90206,
      "createdByName": "Getmanov Andrey",
      "updatedAt": null,
      "updatedBy": -1,
      "updatedByName": null
  }
}

Атрибуты выходной модели шаблона

Атрибут	Тип	Описание
id	string	Идентификатор отчета
name	string	Название отчета
description	string	Описание отчета
error	string	Текст ошибки, если статус расчета не равен `Ok`
status	string	Статус расчета отчета
entityInfo	object	Информация о том, кто запустил расчет отчета

Дополнительная информация по атрибутам

Возможные значения атрибута status:

Unspecified - не определен
Pending - в ожидании расчета
Ok - рассчитан успешно
Error - ошибка расчета
Calculating - рассчитывается в текущий момент

Коды ответа

Код	Описание
200	Запрос успешно исполнен
400	Неверный идентификатор отчета
401	Пользователь не авторизован
404	Отчет не найден
500	Непредвиденная ошибка при обработке запроса

Отчеты о доступности системы

Запустить расчёт отчета о доступности

Отчёт может быть создан только по шаблону. У пользователей, запускающих расчет отчёта, должно быть право на чтение указанного шаблона.

Срок хранения отчета – одни сутки.

По истечению этого срока экспорт результатов расчета невозможен.

POST /api/public/plugins/availability-reports/v1/reports/single

Параметры запроса

Отсутствуют

Пример входной модели

{
  "params": {
    "rsmMapId": 0,
    "configItemIds": [
      0
    ],
    "activityTimes": [
      {
        "days": [
          "Su"
        ],
        "from": "string",
        "to": "string",
        "applyHolidays": true,
        "applyWorkingDays": true
      }
    ],
    "filters": [
      {
        "type": "Including",
        "severities": [
          0
        ],
        "tagIds": [
          0
        ],
        "duration": {
          "type": "GreaterThan",
          "value": 0
        }
      }
    ],
    "withMaintenance": true,
    "recoveryTimeObjective": 0,
    "meanTimeBetweenFailures": true,
    "meanTimeToRestoreService": true,
    "maxDowntime": true
  },
  "name": "string",
  "description": "string",
  "templateId": 0,
  "range": {
    "start": "2024-03-13T08:36:36.314Z",
    "end": "2024-03-13T08:36:36.314Z"
  },
  "expirationTime": 0
}

Поля тела запроса

Название поля	Обязательное поле	Тип поля	Описание
params		`object` or `null`	Параметры отчета. Если `null`, то берется из шаблона.
name		`string` or `null`	Название отчета. Если `null`, то берется из шаблона.
description		`string` or `null`	Описание отчета. Если `null`, то берется из шаблона.
templateId	да	`integer`	Идентификатор шаблона
range		`object` or `null`	Период расчета. Если `null`, то берется из шаблона.
expirationTime		`integer` or `null`	Время хранения отчёта в часах

Поля объекта params:

Название поля	Тип поля	Описание
rsmMapId	`integer` or `null`	Идентификатор карты РСМ. Если `null`, то берется из шаблона.
configItemIds	`integer[]` or `null`	Список идентификаторов КЕ. Если `null`, то берется из шаблона.
activityTimes	`object` or `null`	Список периодов активности. Если `null`, то берется из шаблона.
filters	`object` or `null`	Фильтры сигналов. Если `null`, то берется из шаблона.
withMaintenance	`boolean` or `null`	Учитывать сервисный режим. Если `null`, то берется из шаблона.
recoveryTimeObjective	`integer` or `null`	RTO (максимальное время нахождения КЕ в проблемном статусе). Если `null`, то берется из шаблона.
meanTimeBetweenFailures	`boolean` or `null`	Среднее время наработки на отказ. Если `null`, то берется из шаблона.
meanTimeToRestoreService	`boolean` or `null`	Среднее время восстановления службы. Если `null`, то берется из шаблона.
maxDowntime	`boolean` or `null`	Длительность периода максимального простоя. Если `null`, то берется из шаблона.

Поля объекта activityTimes:

Название поля	Тип поля	Описание
days	`string[]` or `null`	Дни недели `[ Su, Mo, Tu, We, Th, Fr, Sa ]`
from	`string` or `null`	Дата начала периода
to	`string` or `null`	Дата завершения периода
applyHolidays	`boolean` or `null`	Включить праздники
applyWorkingDays	`boolean` or `null`	Включить рабочие дни

Поля объекта filters:

Название поля	Тип поля	Описание
type	`string[]` or `null`	Тип фильтра `Including` или `Excluding`
severities	`integer[]` or `null`	Критичность сигнала
tagIds	`integer[]` or `null`	Идентификаторы тегов
duration	`object` or `null`	Длительность сигнала

Поля объекта duration:

Название поля	Тип поля	Описание
type	`string[]` or `null`	Условие `GreaterThan` или `LessThan`
value	`integer[]` or `null`	Длительность сигнала в секундах

Пример выходной модели

При успешном исполнении запроса возвращается идентификатор отчета

{
    "id": "8df89b87-50cb-4518-bd18-bef4c5aa672c"
}

Атрибуты выходной модели

Атрибут	Тип	Описание
id	string	Идентификатор заказного отчёта

Коды ответа

Код	Описание
200	Запрос успешно выполнен
400	Неверная модель данных в теле запроса. Не найден шаблон с указанным идентификатором. Не удалось выполнить расчёт с указанным шаблоном или настройками.
401	Пользователь не авторизован
403	Недостаточно прав для выполнения действия
500	Непредвиденная ошибка при обработке запроса

Запустить расчёт мультиотчета о доступности

Мультиотчёт может быть создан только по шаблону. У пользователей, запускающих расчет мультиотчёта, должно быть право на чтение указанного шаблона.

Срок хранения мультиотчёта – одни сутки.

По истечению этого срока экспорт результатов расчета невозможен.

POST /api/public/plugins/availability-reports/v1/reports/multi

Параметры запроса

Отсутствуют

Пример входной модели

{
  "params": {
    "templates": [
      {
        "id": 0,
        "params": {
          "rsmMapId": 0,
          "configItemIds": [
            0
          ],
          "activityTimes": [
            {
              "days": [
                "Su"
              ],
              "from": "string",
              "to": "string",
              "applyHolidays": true,
              "applyWorkingDays": true
            }
          ],
          "filters": [
            {
              "type": "Including",
              "severities": [
                0
              ],
              "tagIds": [
                0
              ],
              "duration": {
                "type": "GreaterThan",
                "value": 0
              }
            }
          ],
          "withMaintenance": true,
          "recoveryTimeObjective": 0,
          "meanTimeBetweenFailures": true,
          "meanTimeToRestoreService": true,
          "maxDowntime": true
        },
        "weight": 0
      }
    ]
  },
  "name": "string",
  "description": "string",
  "templateId": 0,
  "range": {
    "start": "2024-03-13T09:59:34.612Z",
    "end": "2024-03-13T09:59:34.612Z"
  },
  "expirationTime": 0
}

Поля тела запроса

Название поля	Обязательное поле	Тип поля	Описание
params		`object` or `null`	Параметры мультиотчета. Если `null`, то берется из шаблона.
name		`string` or `null`	Название мультиотчета. Если `null`, то берется из шаблона.
description		`string` or `null`	Описание мультиотчета. Если `null`, то берется из шаблона.
templateId	да	`integer`	Идентификатор шаблона
range		`object` or `null`	Период расчета. Если `null`, то берется из шаблона.
expirationTime		`integer` or `null`	Время хранения мультиотчета в часах

Поля объекта params:

Название поля	Тип поля	Описание
templates	`object[]` or `null`	Список параметры отчетов, входящих в мультиотчет . Если `null`, то берется из шаблона.

Поля объекта из массива templates:

Название поля	Тип поля	Описание
rsmMapId	`integer` or `null`	Идентификатор карты РСМ. Если `null`, то берется из шаблона.
configItemIds	`integer[]` or `null`	Список идентификаторов КЕ. Если `null`, то берется из шаблона.
activityTimes	`object` or `null`	Список периодов активности. Если `null`, то берется из шаблона.
filters	`object` or `null`	Фильтры сигналов. Если `null`, то берется из шаблона.
withMaintenance	`boolean` or `null`	Учитывать сервисный режим. Если `null`, то берется из шаблона.
recoveryTimeObjective	`integer` or `null`	RTO (максимальное время нахождения КЕ в проблемном статусе). Если `null`, то берется из шаблона.
meanTimeBetweenFailures	`boolean` or `null`	Среднее время наработки на отказ. Если `null`, то берется из шаблона.
meanTimeToRestoreService	`boolean` or `null`	Среднее время восстановления службы. Если `null`, то берется из шаблона.
maxDowntime	`boolean` or `null`	Длительность периода максимального простоя. Если `null`, то берется из шаблона.

Поля объекта activityTimes:

Название поля	Тип поля	Описание
days	`string[]` or `null`	Дни недели `[ Su, Mo, Tu, We, Th, Fr, Sa ]`
from	`string` or `null`	Дата начала периода
to	`string` or `null`	Дата завершения периода
applyHolidays	`boolean` or `null`	Включить праздники
applyWorkingDays	`boolean` or `null`	Включить рабочие дни

Поля объекта filters:

Название поля	Тип поля	Описание
type	`string[]` or `null`	Тип фильтра `Including` или `Excluding`
severities	`integer[]` or `null`	Критичность сигнала
tagIds	`integer[]` or `null`	Идентификаторы тегов
duration	`object` or `null`	Длительность сигнала

Поля объекта duration:

Название поля	Тип поля	Описание
type	`string[]` or `null`	Условие `GreaterThan` или `LessThan`
value	`integer[]` or `null`	Длительность сигнала в секундах

Пример выходной модели

При успешном исполнении запроса возвращается идентификатор мультиотчёта

{
    "id": "be6a6b26-0799-49ca-a9e6-91e2c1c75565"
}

Атрибуты выходной модели

Атрибут	Тип	Описание
id	string	Идентификатор мультиотчёта

Коды ответа

Код	Описание
200	Запрос успешно выполнен
400	Неверная модель данных в теле запроса. Не найден шаблон с указанным идентификатором. Не удалось выполнить расчёт с указанным шаблоном или настройками.
401	Пользователь не авторизован
403	Недостаточно прав для выполнения действия
500	Непредвиденная ошибка при обработке запроса

Экспорт файла отчета доступности

GET /api/public/plugins/availability-reports/v1/reports/{reportId}/export/availability

Параметры запроса

Параметр	Тип	Требуется	Описание
reportId	string	да	Идентификатор отчета
format	string	нет	Тип файла экспорта (по умолчанию Json). Доступны форматы: `Json` и `Xls`
timeZone	string	нет	Временная зона. Примеры значений: `Europe/Moscow`, `Europe/Berlin`, `Asia/Shanghai`

Экспорт файла мультиотчета доступности

GET /api/public/plugins/availability-reports/v1/reports/{reportId}/export/multi/availability

Параметры запроса

Параметр	Тип	Требуется	Описание
reportId	string	да	Идентификатор отчета
format	string	нет	Тип файла экспорта (по умолчанию Json). Доступны форматы: `Json` и `Xls`
timeZone	string	нет	Временная зона. Примеры значений: `Europe/Moscow`, `Europe/Berlin`, `Asia/Shanghai`

Экспорт файла отчета о доступности КЕ

GET /api/public/plugins/availability-reports/v1/reports/{reportId}/export/config-items-availability/{configItemId}

Параметры запроса

Параметр	Тип	Требуется	Описание
reportId	string	да	Идентификатор отчета
configItemId	string	да	Идентификатор КЕ
format	string	нет	Тип файла экспорта (по умолчанию Json). Доступны форматы: `Json` и `Xls`
timeZone	string	нет	Временная зона. Примеры значений: `Europe/Moscow`, `Europe/Berlin`, `Asia/Shanghai`

API - Отчеты

Шаблоны отчетов​

Получение списка доступных пользователю шаблонов​

Параметры запроса​

Пример выходной модели​

Атрибуты выходной модели шаблона​

Коды ответа​

Получение статуса отчета по идентификатору​

Параметры запроса​

Пример выходной модели​

Атрибуты выходной модели шаблона​

Дополнительная информация по атрибутам​

Коды ответа​

Отчеты о доступности системы​

Запустить расчёт отчета о доступности​

Параметры запроса​

Пример входной модели​

Поля тела запроса​

Пример выходной модели​

Атрибуты выходной модели​

Коды ответа​

Запустить расчёт мультиотчета о доступности​

Параметры запроса​

Пример входной модели​

Поля тела запроса​

Пример выходной модели​

Атрибуты выходной модели​

Коды ответа​

Экспорт файла отчета доступности​

Параметры запроса​

Экспорт файла мультиотчета доступности​

Параметры запроса​

Экспорт файла отчета о доступности КЕ​

Параметры запроса​

Шаблоны отчетов

Получение списка доступных пользователю шаблонов

Параметры запроса

Пример выходной модели

Атрибуты выходной модели шаблона

Коды ответа

Получение статуса отчета по идентификатору

Параметры запроса

Пример выходной модели

Атрибуты выходной модели шаблона

Дополнительная информация по атрибутам

Коды ответа

Отчеты о доступности системы

Запустить расчёт отчета о доступности

Параметры запроса

Пример входной модели

Поля тела запроса

Пример выходной модели

Атрибуты выходной модели

Коды ответа

Запустить расчёт мультиотчета о доступности

Параметры запроса

Пример входной модели

Поля тела запроса

Пример выходной модели

Атрибуты выходной модели

Коды ответа

Экспорт файла отчета доступности

Параметры запроса

Экспорт файла мультиотчета доступности

Параметры запроса

Экспорт файла отчета о доступности КЕ

Параметры запроса