polls.vote.get

Scope: polls

Кто может вызывать: Чтение опроса: canReadVote или индивидуальные права ACL опроса. Подробнее: Права доступа

Опрос по ID.

HTTP: GET

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

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

Параметр Тип Обяз. Описание
id int да ID опроса (aliases: voteId, elementId)

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

Ответ в конверте модуля: result.result — полный объект опроса (поля list + descriptionType, imageId, uniqueType, keepIpSec, notify, anonymity, sort, url, timestampX, lamp, флаги уникальности uniqueBySession/Cookie/Ip/UserId/UserDateRegister, allowRevote, required, блоки statistics {counter, questions, answers} и permissions {canRead, canEdit, canParticipate, canReadResult, isVoted}); result.error. Ключи total/next для не-list методов могут отсутствовать в сериализации, если не переданы.

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

Справочник кодов: Коды ошибок.

Код Описание
UNAUTHORIZED Пользователь не авторизован
INTERNAL_ERROR Внутренняя ошибка сервера
ACCESS_DENIED Нет прав на операцию
NOT_FOUND Сущность не найдена
VALIDATION_ERROR Некорректные или неполные параметры

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

curl -G "https://{портал}/rest/{user_id}/{webhook_code}/polls.vote.get.json" \
          -H "Accept: application/json" \
          --data-urlencode "id=15"

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

{
          "result": {
            "result": {
              "id": 15,
              "title": "Опрос о настроении на неделе",
              "description": "",
              "dateStart": "2026-08-21 15:00:00",
              "dateEnd": "2026-09-21 18:00:00",
              "active": "Y",
              "channel": 7,
              "counter": 0,
              "author": 1,
              "state": "CURRENT",
              "descriptionType": "text",
              "imageId": 0,
              "uniqueType": 44,
              "keepIpSec": 1,
              "notify": "N",
              "anonymity": 2,
              "sort": 400,
              "url": "",
              "timestampX": "2026-08-21 15:27:16",
              "lamp": "green",
              "required": true,
              "uniqueBySession": false,
              "uniqueByCookie": false,
              "uniqueByIp": true,
              "uniqueByUserId": true,
              "uniqueByUserDateRegister": false,
              "allowRevote": false,
              "statistics": {
                "counter": 0,
                "questions": 1,
                "answers": 5
              },
              "permissions": {
                "canRead": true,
                "canEdit": true,
                "canParticipate": true,
                "canReadResult": true,
                "isVoted": false
              }
            },
            "error": null
          },
          "time": {
            "start": 1787319171,
            "finish": 1787319171.604516,
            "duration": 0.6045160293579102,
            "processing": 0,
            "date_start": "2026-08-21T16:32:51+03:00",
            "date_finish": "2026-08-21T16:32:51+03:00"
          }
        }

См. также

Предыдущая
vote.exportExcel
Следующая
vote.getRequired