library.enum.competency.list

Scope: library

Кто может вызывать: Сотрудник.

HTTP: GET

Побочные эффекты: none

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

Параметр	Тип	Обяз.	Описание
`limit`	`int`	нет	Размер страницы; по умолчанию 50, максимум 500
`offset`	`int`	нет	Смещение; по умолчанию 0
`fetchAll`	`bool`	нет	Вернуть все строки (защитный лимит `fetchAllMax` из library.schema)
`filter`	`object`	нет	Mongo-style фильтр (`$eq`, `$in`, …); допускается JSON-строка. Алиасы: `listFilter, mongoFilter`

Поля filter (Mongo)

Поле	Описание
`id`, `name`, `code`, `description`	Основные поля
`developingCount`, `havingCount`	Счётчики
`positionId`, `positionName`, `positionCode`	Связь с должностями

Требует модуль ИПР; иначе пустой список.

Возвращаемые данные

Массив компетенций + total, next:

Поле	Тип
`id`, `name`, `code`, `description`
`developingCount`, `havingCount`	`int`
`developmentActions`	`{ required, recommended }` → course/library/others
`positions`	`{ id, name, code }[]`

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

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

Код	Описание
`UNAUTHORIZED`	Пользователь не авторизован
`ACCESS_DENIED`	Нет доступа к разделу «Библиотека»
`INVALID_LIMIT`	`limit` вне диапазона 1..500
`INVALID_OFFSET`	`offset` < 0
`INVALID_FILTER`	Некорректный `filter` или неизвестное поле (`details.allowed`)
`INVALID_FILTER_OPERATOR`	Неизвестный оператор фильтра
`FETCH_ALL_LIMIT_EXCEEDED`	При `fetchAll=true` записей больше защитного лимита
`INTERNAL_ERROR`	Внутренняя ошибка

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

curl -G "https://76590.dev.wehive.digital/rest/1/{webhook_code}/library.enum.competency.list.json" --data-urlencode "limit=1"

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

{
          "result": {
            "result": [
              {
                "id": 1278,
                "name": "Email-маркетинг",
                "code": "",
                "description": "Умение создавать эффективные email-кампании, работать с подписчиками и отслеживать их отклик.",
                "developingCount": 0,
                "havingCount": 0,
                "developmentActions": {
                  "required": {
                    "course": [],
                    "library": [],
                    "others": []
                  },
                  "recommended": {
                    "course": [],
                    "library": [],
                    "others": []
                  }
                },
                "positions": []
              }
            ],
            "error": null
          },
          "next": 1,
          "total": 114
        }