Оценка 360

# assessment360.competency.category.add

Scope: assessment360

Кто может вызывать: Администратор портала или группа HR-отдела из настроек модуля. См. Права доступа

Создаёт категорию (раздел) компетенций.

HTTP: POST

Побочные эффекты: Изменяет состояние данных модуля assessment360.

Параметры метода

Параметр	Тип	Обяз.	Описание
`name`	`string`	да	Название категории
`active`	`bool`	нет	Активность категории
`parentId`	`int`	нет	ID родительской категории, `0` или отсутствие поля = корень
`sort`	`int`	нет	Сортировка, по умолчанию `500`
`color`	`string`	нет	Цвет категории

Ответ возвращается в конверте модуля: result.result — объект категории (id, name, active, parentId, sort, color); result.next — null; result.error — ошибка или null; total — 0.

Обработка ошибок

Справочник кодов: error-codes.md.

Код	Описание
`UNAUTHORIZED`	Пользователь не авторизован
`INTERNAL_ERROR`	Внутренняя ошибка сервера
`VALIDATION_ERROR`	Ошибка валидации входных параметров
`ACCESS_DENIED`	Недостаточно прав для выполнения операции

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.competency.category.add.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "name": "Soft skills",
          "active": true,
          "parentId": 0,
          "sort": 500,
          "color": "#FF5733"
        }'

Пример ответа

{
          "result": {
            "result": {
              "id": 5,
              "name": "Soft skills",
              "active": true,
              "parentId": 0,
              "sort": 500,
              "color": "#FF5733"
            },
            "next": null,
            "error": null
          },
          "total": 0
        }