assessment360.assessment.list

Scope: assessment360

Кто может вызывать: Авторизованный пользователь REST. Подробнее: Права доступа

Возвращает список карточек оценок 360 с поддержкой пагинации и фильтрации.

HTTP: GET

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

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

Параметр Тип Обяз. Описание
limit int нет Размер страницы, по умолчанию 50, максимум 500
offset int нет Смещение
fetchAll bool нет Вернуть все записи одним ответом (максимум 5000; при превышении — FETCH_ALL_LIMIT_EXCEEDED)
filter object нет Фильтр в mongo-style формате

Поля filter (Mongo)

Поддерживаемые поля: id, name, createdBy, modifiedBy, dateCreate, timestampX, assessmentUserId, managerId, status, activeFrom, activeTo, dateActiveFrom, dateActiveTo, position, competentionsIds, assessmentContacts, colleaguesIds, subordinatesIds, departmentId, departmentIds, tags, respondersStatus, respondersRole, isMyTasks.

Также поддерживаются алиасы: elementId, cardId, assessmentCardId, tagName, tagNames, assessmentTags, responderStatus, responderRole, onlyMyTasks, myTasksOnly, departmentIdList.

Для полей status, respondersStatus и respondersRole допускаются значения в виде xmlId enum или ID enum.

Допустимые xmlId статусов оценки (filter.status) — см. assessment360.assessment.status.list (поле code).
Допустимые xmlId статусов респондента (filter.respondersStatus) — см. assessment360.responder.status.list (поле xmlId).

Пример: filter[status][$eq]=assessment_collection.

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

Массив объектов { fields, properties }. Статус карточки — в properties.STATUS.xmlId (значения из assessment.status.list).

Ответ в конверте модуля: result.result, result.next, result.error, total.

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

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

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка сервера
INVALID_LIMIT Некорректное значение limit
INVALID_OFFSET Некорректное значение offset
INVALID_FILTER Некорректный фильтр
INVALID_FILTER_OPERATOR Неизвестный оператор фильтра

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

curl -G "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.assessment.list.json"
          -H "Accept: application/json"
          --data-urlencode "limit=20"
          --data-urlencode "offset=0"
        

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

{
          "result": {
            "result": [
              {
                "fields": {
                  "id": 1301,
                  "iblockId": 30,
                  "name": "Алиса Наумова",
                  "active": "Y",
                  "sort": 500,
                  "dateCreate": "18.06.2026 12:07:44",
                  "createdBy": 1,
                  "dateActiveFrom": "18.06.2026 12:07:44",
                  "dateActiveTo": "30.06.2026 23:59:59"
                },
                "properties": {
                  "STATUS": { "type": "L", "userType": null, "multiple": false, "value": 120, "enumId": 120, "xmlId": "assessment_collection" },
                  "ASSESSMENT_USER": { "type": "S", "userType": "employee", "multiple": false, "value": 15 },
                  "MANAGER": { "type": "S", "userType": "employee", "multiple": false, "value": 1 },
                  "COMPETENTIONS_LIST": { "type": "E", "userType": null, "multiple": true, "value": [1049, 1051] },
                  "ASSESSMENT_EMPLOYEES": { "type": "S", "userType": "employee", "multiple": true, "value": [8, 14] },
                  "ASSESSMENT_TAGS": { "type": "S", "userType": null, "multiple": true, "value": ["rest-test-draft", "черновик-rest"] },
                  "POSITION": { "type": "S", "userType": null, "multiple": false, "value": "Аналитик" }
                }
              }
            ],
            "next": null,
            "error": null
          },
          "total": 2
        }
        

См. также

Предыдущая