assessment360.task.list

Scope: assessment360

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

Возвращает список задач текущего пользователя как респондента (карточки, где он оценивающий). Это не общий список всех респондентов портала.

HTTP: GET

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

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

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

Поля filter (Mongo)

Поддерживаемые поля: id, code, name, dateCreate, dateUpdate, activeTo, assessmentUserId, status, dateFactEnd.

Также поддерживаются алиасы: createdAt, updatedAt, dateEndFact, assessedUser, assessedUserName, assessmentCard, statusId, statusCode.

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

Допустимые xmlId статусов задачи/респондента — см. assessment360.responder.status.list (поле xmlId). В ответе задачи статус приходит как объект { id, name, code }, где code = xmlId.

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

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

Массив объектов задачи. Поля элемента (как в TaskListService::mapRowToRestItem):

Поле Тип Описание
id int ID карточки респондента (задачи)
code string | null CODE карточки респондента
name string NAME карточки оценки (оцениваемого), не «заголовок задачи»
dateCreate string | null ACTIVE_FROM карточки оценки (d.m.Y H:i:s)
dateUpdate string | null TIMESTAMP_X карточки респондента
activeTo string | null ACTIVE_TO карточки оценки
status object { id, name, code } — enum статуса респондента; code = xmlId
dateFactEnd string | null Фактическое завершение
position string Должность оцениваемого (WORK_POSITION); может быть ""
createdAt string | null Алиас dateCreate
updatedAt string | null Алиас dateUpdate
dateEndFact string | null Алиас dateFactEnd
assessmentUser object Оцениваемый: { id, image, position } (image — путь к фото или "")

Поля assessmentCardId, role, ФИО оцениваемого в ответе нет.

Ответ в конверте модуля: 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.task.list.json"
          -H "Accept: application/json"
          --data-urlencode "limit=20"
          --data-urlencode "offset=0"

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

{
          "result": {
            "result": [
              {
                "id": 1177,
                "code": "abc123def456",
                "name": "Алиса Наумова",
                "dateCreate": "18.06.2026 12:07:44",
                "dateUpdate": "18.06.2026 12:11:53",
                "activeTo": "30.06.2026 23:59:59",
                "status": {
                  "id": 201,
                  "name": "Ожидание",
                  "code": "waiting"
                },
                "dateFactEnd": null,
                "position": "Аналитик",
                "createdAt": "18.06.2026 12:07:44",
                "updatedAt": "18.06.2026 12:11:53",
                "dateEndFact": null,
                "assessmentUser": {
                  "id": 15,
                  "image": "/upload/main/abc/photo.jpg",
                  "position": "Аналитик"
                }
              }
            ],
            "next": null,
            "error": null
          },
          "total": 1
        }

Если у пользователя нет активных задач респондента, result.result = [], total = 0.

См. также

Предыдущая
Обзор раздела
Следующая
assessment360.task.get