Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

МетодОписаниеПараметрыСхема ответаПример использования
GET /api/v1/groupsПолучение информации по всем группам

Query-параметры:

  • id (uint64): Уникальный ID группы
  • name (string): Имя группы

  • type (GroupType): Тип группы

  • path (string): Полный путь до группы по имени

  • parentGroupId (uint64): ID родительской группы

  • idPath (string): Полный путь до группы по ID

  • offset (uint64): Начальный элемент пагинации

  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации

Блок кода
title200 - успешная операция
{
   "groups":[Group],
   "total": string
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/groups


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "groups": [
        {
            "id": "1",
            "name": "eccm",
            "parentGroupId": "0",
            "type": "GROUPS",
            "path": "eccm/",
            "idPath": "1/"
        },
        {
            "id": "100",
            "name": "group-1",
            "parentGroupId": "1",
            "type": "EMPTY",
            "path": "eccm/group-1/",
            "idPath": "1/100/"
        }
    ],
    "total":2
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Failed to get groups",
    "code": 400,
    "errors": [
        {
            "domain": "backend-ui",
            "message": "Failed to get groups",
            "reason": "Invalid group type: test",
            "extendedHelp": "Provide valid parameter value and try again"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/groups/{id}Получение информации по конкретной группе
Path-параметры: 
  • id (uint64): Уникальный ID группы



Блок кода
title200 - успешная операция
Group


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/groups/1


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "id": "1",
    "name": "eccm",
    "parentGroupId": "0",
    "type": "GROUPS",
    "path": "eccm/",
    "idPath": "1/"
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Entity not found",
    "code": 400,
    "errors": [
        {
            "domain": "data-presenter",
            "message": "Entity not found",
            "reason": "Failed to find GroupInfo with id 44 in the database",
            "extendedHelp": "Please enter only id of the existing entity"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/groups/statisticsПолучение расширенной информации по всем группам

Query-параметры:

  • id (uint64): Уникальный ID группы
  • name (string): Имя группы

  • type (enum): Тип группы

  • path (string): Полный путь до группы по имени

  • parentGroupId (uint64): ID родительской группы

  • idPath (string): Полный путь до группы по ID

  • offset (uint64): Начальный элемент пагинации

  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации


Блок кода
title200 - успешная операция
{
   "groupStatistics":[GroupStatistics],
   "total": string
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/groups/statistics


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "groupStatistics": [
        {
            "id": "1",
            "name": "eccm",
            "parentGroupId": "0",
            "totalDevices": "0",
            "hasChildren": true,
            "problemDevices": "0",
            "unavailableDevices": "0",
            "devicesWithAvailabilityStatuses": "0",
            "disabledDevices": "0",
            "enabledDevices": "0",
            "type": "GROUPS",
            "idPath": "1/",
            "path": "eccm/"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Failed to get groups",
    "code": 400,
    "errors": [
        {
            "domain": "backend-ui",
            "message": "Failed to get groups",
            "reason": "Invalid group type: test",
            "extendedHelp": "Provide valid parameter value and try again"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/groups/{id}/statisticsПолучение расширенной информации по конкретной группе
Path-параметры: 
  • id (uint64): Уникальный ID группы



Блок кода
title200 - успешная операция
GroupStatistic


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/groups/1/statistics


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "id": "1",
    "name": "eccm",
    "parentGroupId": "0",
    "totalDevices": "0",
    "hasChildren": true,
    "problemDevices": "0",
    "unavailableDevices": "0",
    "devicesWithAvailabilityStatuses": "0",
    "disabledDevices": "0",
    "enabledDevices": "0",
    "type": "GROUPS",
    "idPath": "1/",
    "path": "eccm/"
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Entity not found",
    "code": 400,
    "errors": [
        {
            "domain": "data-presenter",
            "message": "Entity not found",
            "reason": "Failed to find GroupInfo with id 44 in the database",
            "extendedHelp": "Please enter only id of the existing entity"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/devicesПолучение информации по всем устройствам

Query-параметры:

  • id (uint64): ID устройства
  • ip (string): IP устройства
  • hostname (string): Имя хоста точки доступа
  • label (string): Имя устройства
  • mac (string): MAC-адрес
  • model (string): Модель
  • serialNumber (string): Серийный номер
  • firmwareVersion (string): Версия ПО
  • maintenanceStatus (MaintenanceStatus): Статус обслуживания устройства
  • groupId (string): ID родительской группы
  • note (string): Заметка об устройстве
  • availabilityIcmpStatus (AvailabilityStatus): Статус доступности ICMP
  • availabilitySnmpStatus (AvailabilityStatus): Статус доступности SNMP
  • availabilitySshStatus (AvailabilityStatus): Статус доступности SSH
  • offset (uint64): Начальный элемент пагинации

  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации


Блок кода
title200 - успешная операция
{
    "devices": [Device],
    "total": "uint64"
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract


Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/devices


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "devices": [
        {
            "id": "100",
            "label": "100.122.0.111_ESR-200",
            "ip": "100.122.0.111",
            "hostname": "testhost",
            "mac": "cc:9d:a2:70:af:d8",
            "model": "ESR-200",
            "serialNumber": "NP15011091",
            "firmwareVersion": "1.34.4 build 10",
            "maintenanceStatus": "ENABLED",
            "groupId": "100",
            "note": "",
            "isStack": false,
            "availabilityIcmpStatus": "UP",
            "availabilitySnmpStatus": "UP",
            "availabilitySshStatus": "DOWN"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Failed to get devices",
    "code": 400,
    "errors": [
        {
            "domain": "backend-ui",
            "message": "Failed to get devices",
            "reason": "Invalid maintenance status: test",
            "extendedHelp": "Provide valid parameter value and try again"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}



GET /api/v1/devices/{id}Получение информации по конкретному устройству
Path-параметры: 
  • id (uint64): Уникальный ID устройства



Блок кода
title200 - успешная операция
Device


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/devices/100


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "id": "100",
    "label": "100.122.0.111_ESR-200",
    "ip": "100.122.0.111",
    "hostname": "testhost",
    "mac": "cc:9d:a2:70:af:d8",
    "model": "ESR-200",
    "serialNumber": "NP15011091",
    "firmwareVersion": "1.34.4 build 10",
    "maintenanceStatus": "ENABLED",
    "groupId": "100",
    "note": "",
    "isStack": false,
    "availabilityIcmpStatus": "UP",
    "availabilitySnmpStatus": "UP",
    "availabilitySshStatus": "DOWN"
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Entity not found",
    "code": 400,
    "errors": [
        {
            "domain": "data-presenter",
            "message": "Entity not found",
            "reason": "Failed to find DeviceInfo with id 44 in the database",
            "extendedHelp": "Please enter only id of the existing entity"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/devices/{id}/eventsПолучение списка событий по конкретному устройству

Path-параметры: 

  • id (uint64): Уникальный ID устройства

Query-параметры:

  • id (uint64): ID события
  • severity (Severity): Уровень важности события
  • description (string): Описание события

  • timestampCreatedFrom (uint64): Начальное время создания события

  • timestampCreatedTo (uint64): Конечное время создания события

  • offset (uint64): Начальный элемент пагинации

  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации

Блок кода
title200 - успешная операция
{
    "events": [Event],
    "total": "uint64"
}
 
Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract


Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/devices/100/events


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "events": [
        {
            "id": "1",
            "sourceType": "METRIC",
            "severity": "ALERT",
            "createdAt": "1770190451591",
            "label": "WLC недоступен по SNMP",
            "description": "Устройство недоступно по SNMP",
            "deviceId": "100",
            "deviceIp": "100.122.0.108",
            "deviceLabel": "100.122.0.108_WLC-15",
            "deviceHostname": "ECCM-WLC"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Entity not found",
    "code": 400,
    "errors": [
        {
            "domain": "data-presenter",
            "message": "Entity not found",
            "reason": "Failed to find DeviceInfo with id 44 in the database",
            "extendedHelp": "Please enter only id of the existing entity"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}



GET /api/v1/devices/{id}/problemsПолучение списка проблем по конкретному устройству

Path-параметры: 

  • id (uint64): Уникальный ID устройства

Query-параметры:

  • id (uint64): ID проблемы
  • severity (Severity): Уровень важности проблемы
  • status (ProblemStatus): Статус проблемы
  • description (string): Описание проблемы

  • timestampCreatedFrom (uint64): Начальное время создания проблемы

  • timestampCreatedTo (uint64): Конечное время создания проблемы

  • timestampClosedFrom (uint64): Начальное время закрытия проблемы
  • timestampClosedTo (uint64): Конечное время закрытия проблемы
  • timestampAcknowledgedFrom (uint64): Начальное время подтверждения проблемы
  • timestampAcknowledgedTo (uint64): Конечное время подтверждения проблемы
  • timestampAssignedFrom (uint64): Начальное время назначения проблемы
  • timestampAssignedTo (uint64): Конечное время назначения проблемы
  • offset (uint64): Начальный элемент пагинации
  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации


Блок кода
title200 - успешная операция
{
    "problems": [Problem],
    "total": "uint64"
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract



Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/devices/100/problems


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "problems": [
        {
            "id": "1",
            "status": "CLOSED",
            "severity": "ALERT",
            "createdAt": "1770190451591",
            "isAcknowledged": false,
            "closedBy": "System",
            "closedAt": "1770190466098",
            "label": "Устройство недоступно по протоколу SNMP",
            "description": "Потеря доступа к устройству по протоколу SNMP",
            "deviceId": "100",
            "deviceIp": "100.122.0.108",
            "deviceLabel": "100.122.0.108_WLC-15",
            "deviceHostname": "ECCM-WLC",
            "groupId": "100",
            "groupName": "1",
            "duration": "14507"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Entity not found",
    "code": 400,
    "errors": [
        {
            "domain": "data-presenter",
            "message": "Entity not found",
            "reason": "Failed to find DeviceInfo with id 44 in the database",
            "extendedHelp": "Please enter only id of the existing entity"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}



GET /api/v1/devices/{id}/tasksПолучение списка задач по конкретному устройству

Path-параметры: 

  • id (uint64): Уникальный ID устройства

Query-параметры:

  • id (uint64): ID задачи
  • status (TaskStatus): Статус задачи
  • type (TaskType): Тип задачи
  • deviceId (uint64): ID устройства

  • deviceIp (string): IP устройства
  • deviceHostname (string): Hostname устройства
  • deviceLabel (string): Название устройства
  • timestampCreatedFrom (uint64): Начальное время создания задачи
  • timestampCreatedTo (uint64): Конечное время создания задачи

  • timestampStartFrom (uint64): Начальное время выполнения задачи
  • timestampStartTo (uint64): Конечное время выполнения задачи
  • timestampStoppedFrom (uint64): Начальное время остановки задачи
  • timestampStoppedTo (uint64): Конечное время остановки задачи
  • offset (uint64): Начальный элемент пагинации
  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации

Блок кода
title200 - успешная операция
{
    "tasks": [Task],
    "total": "uint64"
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract


  

Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/devices/100/tasks


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "tasks": [
        {
            "id": "19",
            "status": "FAILED",
            "type": "UPDATE_DEVICE_INFO_GROUP",
            "createdAt": "1770190212668",
            "scheduledAt": "0",
            "startAt": "1770190212681",
            "stoppedAt": "1770190232600",
            "author": "System",
            "errorCause": "Child task failed",
            "deviceId": "100",
            "deviceIp": "100.122.0.108",
            "deviceLabel": "100.122.0.108_WLC-15",
            "deviceHostname": "ECCM-WLC"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Entity not found",
    "code": 400,
    "errors": [
        {
            "domain": "data-presenter",
            "message": "Entity not found",
            "reason": "Failed to find DeviceInfo with id 44 in the database",
            "extendedHelp": "Please enter only id of the existing entity"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/eventsПолучение списка всех событий

Query-параметры:

  • id (uint64): ID события
  • severity (Severity): Уровень важности события
  • description (string): Описание события

  • timestampCreatedFrom (uint64): Начальное время создания события

  • timestampCreatedTo (uint64): Конечное время создания события

  • offset (uint64): Начальный элемент пагинации

  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации

Блок кода
title200 - успешная операция
{
    "events": [Event],
    "total": "uint64"
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract


Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/events


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "events": [
        {
            "id": "1",
            "sourceType": "METRIC",
            "severity": "ALERT",
            "createdAt": "1770190451591",
            "label": "WLC недоступен по SNMP",
            "description": "Устройство недоступно по SNMP",
            "deviceId": "106",
            "deviceIp": "100.122.0.108",
            "deviceLabel": "100.122.0.108_WLC-15",
            "deviceHostname": "ECCM-WLC"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Failed to get events",
    "code": 400,
    "errors": [
        {
            "domain": "backend-ui",
            "message": "Failed to get events",
            "reason": "Invalid severity: test",
            "extendedHelp": "Provide valid parameter value and try again"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/problemsПолучение списка всех проблем

Query-параметры:

  • id (uint64): ID проблемы
  • severity (Severity): Уровень важности проблемы
  • status (ProblemStatus): Статус проблемы
  • description (string): Описание проблемы

  • timestampCreatedFrom (uint64): Начальное время создания проблемы

  • timestampCreatedTo (uint64): Конечное время созданияпроблемы

  • timestampClosedFrom (uint64): Начальное время закрытия проблемы
  • timestampClosedTo (uint64): Конечное время создания проблемы
  • timestampAcknowledgedFrom (uint64): Начальное время подтверждения проблемы
  • timestampAcknowledgedTo (uint64): Конечное время подтверждения проблемы
  • timestampAssignedFrom (uint64): Начальное время назначения проблемы
  • timestampAssignedTo (uint64): Конечное время назначения проблемы
  • offset (uint64): Начальный элемент пагинации
  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации

Блок кода
title200 - успешная операция
{
    "problems": [Problem],
    "total": "uint64"
}


Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/problems


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "problems": [
        {
            "id": "1",
            "status": "CLOSED",
            "severity": "ALERT",
            "createdAt": "1770190451591",
            "isAcknowledged": false,
            "closedBy": "System",
            "closedAt": "1770190466098",
            "label": "Устройство недоступно по протоколу SNMP",
            "description": "Потеря доступа к устройству по протоколу SNMP",
            "deviceId": "106",
            "deviceIp": "100.122.0.108",
            "deviceLabel": "100.122.0.108_WLC-15",
            "deviceHostname": "ECCM-WLC",
            "groupId": "100",
            "groupName": "1",
            "duration": "14507"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Failed to get problems",
    "code": 400,
    "errors": [
        {
            "domain": "backend-ui",
            "message": "Failed to get problems",
            "reason": "Invalid severity: test",
            "extendedHelp": "Provide valid parameter value and try again"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


GET /api/v1/tasks

Получение списка всех задач

Query-параметры:

  • id (uint64): ID задачи
  • status (TaskStatus): Статус задачи
  • type (TaskType): Тип задачи
  • deviceId (uint64): ID устройства

  • deviceIp (string): IP устройства
  • deviceHostname (string): Hostname устройства
  • deviceLabel (string): Название устройства
  • timestampCreatedFrom (uint64): Начальное время создания задачи
  • timestampCreatedTo (uint64): Конечное время создания задачи

  • timestampStartFrom (uint64): Начальное время запуска задачи
  • timestampStartTo (uint64): Конечное время запуска задачи
  • timestampStoppedFrom (uint64): Начальное время завершения задачи
  • timestampStoppedTo (uint64): Конечное время завершения задачи
  • offset (uint64): Начальный элемент пагинации
  • size (uint64): Ограничение максимального количества элементов в ответе

  • total (boolean): Общее количество найденных объектов без учёта лимита пагинации

Блок кода
title200 - успешная операция
{
    "tasks": [Task],
    "total": "uint64"
}
Блок кода
title400 - ошибка валидации
AnswerContract


Блок кода
title500 - ошибка сервера
AnswerContract
Блок кода
languagebash
curl -X GET -H "Authorization: Bearer ${TOKEN}" http://localhost/api/v1/tasks


Раскрыть
titleКод ответа 200 - успешный запрос
Блок кода
{
    "tasks": [
        {
            "id": "19",
            "status": "FAILED",
            "type": "UPDATE_DEVICE_INFO_GROUP",
            "createdAt": "1770190212668",
            "scheduledAt": "0",
            "startAt": "1770190212681",
            "stoppedAt": "1770190232600",
            "author": "System",
            "errorCause": "Child task failed",
            "deviceId": "106",
            "deviceIp": "100.122.0.108",
            "deviceLabel": "100.122.0.108_WLC-15",
            "deviceHostname": "ECCM-WLC"
        }
    ]
}
Раскрыть
titleКод ответа 400 - ошибка валидации
Блок кода
{
    "message": "Failed to get tasks",
    "code": 400,
    "errors": [
        {
            "domain": "backend-ui",
            "message": "Failed to get tasks",
            "reason": "Invalid type: test",
            "extendedHelp": "Provide valid parameter value and try again"
        }
    ]
}
Раскрыть
titleКод ответа 500 - ошибка сервера
Блок кода
{
	"message": "RPC error",
	"code": 500,
	"errors": [
		{
			"domain": "backend-ui",
			"message": "RPC error",
			"reason": "RPC timeout",
			"extendedHelp": "Please try again later or contact support"
		}
	]
}


...