# assessment360.responder.list
Scope:
assessment360Кто может вызывать: Доступ на просмотр карточки процедуры (
canViewAssessmentCard). См. Права доступа
Возвращает список карточек респондентов выбранной оценки с пагинацией и фильтром.
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
assessmentId |
int |
да | ID карточки процедуры (оценки), для которой нужен список респондентов |
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение |
fetchAll |
bool |
нет | Вернуть все записи одним ответом (максимум 5000; при превышении — FETCH_ALL_LIMIT_EXCEEDED) |
filter |
object |
нет | Фильтр в mongo-style формате |
Поля filter (Mongo)
Поддерживаемые поля: dateCreate, timestampX, active, dateActiveFrom, dateActiveTo, name, code, assessmentCardId, assessorUserId, assessorContactId, dateFactEnd, role, status, competencyIds.
Также поддерживаются алиасы: userId, employeeId, contactId, competenceIds, competencesAssessed, responderStatus, responderRole.
Для полей role и status допускаются значения в виде xmlId enum или ID enum.
Допустимые xmlId статусов респондента (filter.status) — см. assessment360.responder.status.list (поле xmlId).
Пример: filter[status][$eq]=waiting.
Возвращаемые данные
Ответ в конверте модуля: result.result, result.next, result.error, total.
Каждый элемент — объект { fields, properties } (в т.ч. STATUS, ROLE, ASSESSMENT_CARD). Статус — properties.STATUS.xmlId (значения из responder.status.list).
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
Не передан или некорректен assessmentId |
PERMISSION_DENIED |
Нет доступа к карточке процедуры (canViewAssessmentCard) |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
INVALID_LIMIT |
Некорректное значение limit |
INVALID_OFFSET |
Некорректное значение offset |
INVALID_FILTER |
Некорректный фильтр |
INVALID_FILTER_OPERATOR |
Неизвестный оператор фильтра |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.responder.list.json"
-H "Accept: application/json"
--data-urlencode "assessmentId=1169"
--data-urlencode "limit=20"
--data-urlencode "offset=0"
Пример ответа
{
"result": {
"result": [
{
"fields": {
"id": 214,
"name": "Иванов Иван",
"active": "Y",
"code": "RSP-7F13F9A2",
"dateCreate": "18.06.2026 12:07:44"
},
"properties": {
"STATUS": { "type": "L", "userType": null, "multiple": false, "value": 201, "enumId": 201, "xmlId": "waiting" },
"ROLE": { "type": "L", "userType": null, "multiple": false, "value": 205, "enumId": 205, "xmlId": "collega" },
"ASSESSMENT_CARD": { "type": "E", "userType": null, "multiple": false, "value": 331 }
}
}
],
"next": null,
"error": null
},
"total": 1
}