Метод createCategory

Создание категории конфигурации.

POST /v1/categories

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

CategoryCreateRequest

Пример запроса

{
  "id": "office",
  "name": "Офис",
  "description": "Категория программ для работы в сети Интернет",
  "color": "00ff00",
  "iconCode": "ms_office_icon"
}

Тип контента

application/json

Ответы

Код Сообщение Тип данных / объект схемы (DTO) Пример

200

Набор параметров созданной категории конфигурации

CategoryResponse

 
{
  "createdAt": "2023-08-27T09:37:40.000Z",
  "color": "00ff00",
  "name": "Офис",
  "description": "Категория программ для работы в сети Интернет",
  "iconCode": "ms_office_icon",
  "id": "office",
  "updatedAt": "2023-08-27T09:37:40.000Z"
}

400

Некорректные параметры запроса

BasicError

 
{
  "code": "validation_failed",
  "message": "createCategory.createCategoryRequest.color: must match `[A-Fa-f0-9]+`"
}

401

Ошибка аутентификации

500

Внутренняя ошибка

BasicError

 
{
  "code": "internal_error",
  "message": "Database is unavailable"
}