polls.vote.status.list
Scope:
pollsКто может вызывать: Чтение опроса:
canReadVoteили индивидуальные права ACL опроса. Подробнее: Права доступа
Справочник состояний опроса (CURRENT, FINISHED, NOT_ACTIVE).
HTTP: GET
Побочные эффекты: нет
Для list-методов Bitrix REST выносит total и next на верхний уровень ответа (рядом с result). Внутри конверта модуля — только result и error.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение, по умолчанию 0 |
fetchAll |
bool |
нет | Вернуть все записи одним ответом (лимит rest_fetch_all_max, по умолчанию 5000) |
filter |
object |
нет | Mongo-фильтр. Поля: id, xmlId, name. xmlId: CURRENT |
Пагинация
limit (по умолчанию 50, максимум 500), offset (по умолчанию 0), fetchAll (защитный лимит записей из настройки модуля, по умолчанию 5000; при превышении — FETCH_ALL_LIMIT_EXCEEDED).
Операторы Mongo-фильтра: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin.
Возвращаемые данные
Ответ в конверте модуля: result.result — массив состояний { id, xmlId, name } (xmlId: CURRENT|FINISHED|NOT_ACTIVE); 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 записей больше защитного лимита |
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/polls.vote.status.list.json" \
-H "Accept: application/json" \
--data-urlencode "limit=50"
Пример ответа
{
"result": {
"result": [
{
"id": 1,
"xmlId": "CURRENT",
"name": "Текущий"
},
{
"id": 2,
"xmlId": "FINISHED",
"name": "Завершенный"
},
{
"_truncated": "... ещё 1 элементов"
}
],
"error": null
},
"total": 3,
"time": {
"start": 1787319171,
"finish": 1787319171.934765,
"duration": 0.934765100479126,
"processing": 0,
"date_start": "2026-08-21T16:32:51+03:00",
"date_finish": "2026-08-21T16:32:51+03:00"
}
}