polls.answer.add
Scope:
pollsКто может вызывать: Редактирование опроса:
canEditVote(администратор модуля/опроса или права на канал). Подробнее: Права доступа
Создание варианта ответа.
HTTP: POST
Побочные эффекты: нет
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
questionId |
int |
да | ID родительского вопроса (обязательно при создании) |
message |
string |
нет | Текст ответа; для типов NUMBER/SCALE — числовая строка |
fieldType |
string |
нет | Тип: xmlId или числовой ID из polls.answer.type.list |
active |
string |
нет | Y/N или bool |
cSort |
int |
нет | Сортировка (alias: sort) |
messageType |
string |
нет | html, text или num |
color |
string |
нет | Цвет ответа (hex) |
imageId |
int |
нет | ID файла изображения |
comment |
int |
нет | ID режима комментария (aliases: ufCommentSettings, UF_COMMENT_SETTINGS) |
fields |
object |
нет | Необязательная обёртка с теми же полями |
Возвращаемые данные
Ответ в конверте модуля: result.result — созданный ответ (как polls.answer.get); result.error. Ключи total/next для не-list методов могут отсутствовать в сериализации, если не переданы.
Обработка ошибок
Справочник кодов: Коды ошибок.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
ACCESS_DENIED |
Нет прав на операцию |
VALIDATION_ERROR |
Некорректные или неполные параметры |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/polls.answer.add.json" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"questionId": 52,
"message": "Вариант 1",
"active": "Y"
}'
Пример ответа
{
"result": {
"result": {
"id": 204,
"message": "Doc A",
"imageId": 0,
"active": "Y",
"counter": 0,
"cSort": 10,
"comment": 0,
"color": ""
},
"error": null
},
"time": {
"start": 1787319174,
"finish": 1787319174.282364,
"duration": 0.2823638916015625,
"processing": 0,
"date_start": "2026-08-21T16:32:54+03:00",
"date_finish": "2026-08-21T16:32:54+03:00"
}
}
Предыдущая
Следующая