polls.vote.add

Scope: polls

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

Создание опроса.

HTTP: POST

Побочные эффекты: Создаёт запись опроса; опционально можно передать rights.

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

Параметр Тип Обяз. Описание
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 Нет прав на операцию
VALIDATION_ERROR Некорректные или неполные параметры

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/polls.vote.add.json" \
          -H "Content-Type: application/json" \
          -H "Accept: application/json" \
          -d '{
          "title": "Новый опрос",
          "channelId": 1,
          "active": "Y"
        }'

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

{
          "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.856805,
            "duration": 0.8568050861358643,
            "processing": 0,
            "date_start": "2026-08-21T16:32:53+03:00",
            "date_finish": "2026-08-21T16:32:53+03:00"
          }
        }
Предыдущая
vote.access.set
Следующая
vote.channel.list