polls.vote.update

Scope: polls

Кто может вызывать: Редактирование опроса: canEditVote (администратор модуля/опроса или права на канал). Подробнее: Права доступа

Частичное обновление полей опроса (patch).

HTTP: POST

Побочные эффекты: Обновляет только переданные поля.

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

Параметр Тип Обяз. Описание
id int да ID опроса (aliases: voteId, elementId)
title string нет Название опроса (обязательно при создании)
channelId int нет ID канала (обязательно при создании)
description string нет Описание опроса
descriptionType string нет html или text
dateStart string нет Дата и время начала (alias: dateFrom)
dateEnd string нет Дата и время окончания (alias: dateTo)
active string нет Y/N или bool
imageId int нет ID файла изображения
sort int нет Порядок сортировки (alias: cSort)
url string нет Путь/URL
uniqueType int нет Режим уникальности голоса
uniqueBySession bool нет Запретить повторное голосование по сессии
uniqueByCookie bool нет Запретить повторное голосование по cookie
uniqueByIp bool нет Запретить повторное голосование по IP
keepIpSec int нет Интервал уникальности по IP, секунды
uniqueByUserId bool нет Запретить повторное голосование авторизованному пользователю
uniqueByUserDateRegister bool нет Запретить голосование пользователям, зарегистрированным после начала опроса
allowRevote bool нет Разрешить изменение голоса (переголосование)
notify string нет Флаг уведомлений
anonymity int нет Режим анонимности
required bool нет Флаг обязательного опроса
rights array нет Необязательный массив прав доступа
fields object нет Необязательная обёртка с теми же полями

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

Ответ в конверте модуля: result.result — обновлённый опрос (как polls.vote.get); result.error. Ключи total/next для не-list методов могут отсутствовать в сериализации, если не переданы.

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

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

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

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/polls.vote.update.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          -d '{
          "id": 15,
          "description": "Обновлённое описание"
        }'

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

{
          "result": {
            "result": {
              "id": 27,
              "title": "Docs capture 1787319173",
              "description": "",
              "dateStart": "2026-08-21 16:32:53",
              "dateEnd": "2026-08-22 16:32:53",
              "active": "Y",
              "channel": 6,
              "counter": 0,
              "author": 1,
              "state": "CURRENT",
              "descriptionType": "text",
              "imageId": 0,
              "uniqueType": 36,
              "keepIpSec": 604800,
              "notify": "N",
              "anonymity": 1,
              "sort": 100,
              "url": "",
              "timestampX": "2026-08-21 16:32:53",
              "lamp": "green",
              "required": false,
              "uniqueBySession": false,
              "uniqueByCookie": false,
              "uniqueByIp": true,
              "uniqueByUserId": true,
              "uniqueByUserDateRegister": false,
              "allowRevote": true,
              "statistics": {
                "counter": 0,
                "questions": 0,
                "answers": 0
              },
              "permissions": {
                "canRead": true,
                "canEdit": true,
                "canParticipate": true,
                "canReadResult": true,
                "isVoted": false
              }
            },
            "error": null
          },
          "time": {
            "start": 1787319173,
            "finish": 1787319173.95356,
            "duration": 0.9535601139068604,
            "processing": 0,
            "date_start": "2026-08-21T16:32:53+03:00",
            "date_finish": "2026-08-21T16:32:53+03:00"
          }
        }
Предыдущая
vote.status.list
Следующая
Обзор раздела