polls.question.list
Scope:
pollsКто может вызывать: Чтение опроса:
canReadVoteили индивидуальные права ACL опроса. Подробнее: Права доступа
Список вопросов опроса. Обязателен voteId (в filter или на верхнем уровне запроса).
HTTP: GET
Побочные эффекты: нет
Для list-методов Bitrix REST выносит total и next на верхний уровень ответа (рядом с result). Внутри конверта модуля — только result и error.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
voteId |
int |
да | ID опроса (или filter.voteId) |
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение, по умолчанию 0 |
fetchAll |
bool |
нет | Вернуть все записи одним ответом (лимит rest_fetch_all_max, по умолчанию 5000) |
filter |
object |
нет | Mongo-фильтр. Поля: id, voteId, question, fieldType, required, diagram, counter, cSort, imageId, dependsOnQuestionId, dependsOnAnswerId. Aliases: questionId→id, title→question, sort→cSort, dependedQuestionId/dependedId→dependsOnQuestionId. |
hideUnmetDependencies |
bool |
нет | Если true, скрывать вопросы с невыполненной зависимостью |
Пагинация
limit (по умолчанию 50, максимум 500), offset (по умолчанию 0), fetchAll (защитный лимит записей из настройки модуля, по умолчанию 5000; при превышении — FETCH_ALL_LIMIT_EXCEEDED).
Операторы Mongo-фильтра: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin.
Возвращаемые данные
Ответ в конверте модуля: result.result — массив вопросов: id, question, fieldType { id, xmlId }, cSort, required, diagram, counter, imageId, dependsOnQuestionId, dependsOnAnswerId; result.error; result.next — смещение следующей страницы или null; верхнеуровневый Bitrix total — общее число записей.
Обработка ошибок
Справочник кодов: Коды ошибок.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
ACCESS_DENIED |
Нет прав на операцию |
INVALID_LIMIT |
limit вне диапазона 1..500 |
INVALID_OFFSET |
offset < 0 |
INVALID_FILTER |
Некорректный filter или неизвестное поле |
INVALID_FILTER_OPERATOR |
Неизвестный оператор фильтра |
FETCH_ALL_LIMIT_EXCEEDED |
При fetchAll=true записей больше защитного лимита |
VALIDATION_ERROR |
Не передан обязательный voteId |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/polls.question.list.json" \
-H "Accept: application/json" \
--data-urlencode "voteId=15" \
--data-urlencode "limit=50"
Пример ответа
{
"result": {
"result": [
{
"id": 52,
"question": "Какова вероятность того, что вы порекомендуете нашу компанию в качестве работодателя своим друзьям или знакомым?",
"fieldType": {
"id": 0,
"xmlId": "RADIO"
},
"cSort": 100,
"required": "Y",
"diagram": "Y",
"counter": 0,
"imageId": 0,
"dependsOnQuestionId": 0,
"dependsOnAnswerId": 0
}
],
"error": null
},
"total": 1,
"time": {
"start": 1787319172,
"finish": 1787319172.187358,
"duration": 0.18735790252685547,
"processing": 0,
"date_start": "2026-08-21T16:32:52+03:00",
"date_finish": "2026-08-21T16:32:52+03:00"
}
}