polls.vote.exportExcel

Scope: polls

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

Экспорт результатов опроса в файл (как в UI).

HTTP: GET

Побочные эффекты: нет. Выгрузка формируется в памяти; файл на сервере не создаётся (выгрузка содержит все бюллетени и не должна лежать в публичном /upload).

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

Параметр Тип Обяз. Описание
id int да ID опроса (aliases: voteId, elementId)
type string нет Формат выгрузки: xls (по умолчанию, HTML-таблицы в .xls — как групповой экспорт в UI) или html
inline string нет Y — дополнительно вернуть содержимое выгрузки в поле content (base64). По умолчанию N

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

Ответ в конверте модуля: result.result — { fileId, url, name, contentType, size, content? }:

  • fileId — всегда 0 (оставлен для совместимости, устарел: файл больше не сохраняется);
  • url — ссылка на скачивание выгрузки (/bitrix/services/main/ajax.php?action=ithive:polls.Vote.downloadExport&...). Ссылка действует 10 минут и только для того же пользователя в авторизованной сессии портала; при скачивании права проверяются заново, файл отдаётся как вложение. Интеграциям без сессии портала используйте inline=Y;
  • name — имя файла (vote<ID>.xls или vote<ID>.html), contentType — MIME-тип, size — размер в байтах;
  • content — содержимое файла в base64, только при inline=Y;

result.error. Текст вопросов, ответов и имён в выгрузке экранирован как HTML; HTML-разметка вопросов выводится как обычный текст. Ключи total/next для не-list методов могут отсутствовать в сериализации, если не переданы.

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

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

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

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

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

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

{
          "result": {
            "result": {
              "fileId": 0,
              "url": "/bitrix/services/main/ajax.php?action=ithive%3Apolls.Vote.downloadExport&id=15&type=html&token=...",
              "name": "vote15.html",
              "contentType": "text/html",
              "size": 1067
            },
            "error": null
          },
          "time": {
            "start": 1787319173,
            "finish": 1787319173.723962,
            "duration": 0.7239620685577393,
            "processing": 0,
            "date_start": "2026-08-21T16:32:53+03:00",
            "date_finish": "2026-08-21T16:32:53+03:00"
          }
        }
Предыдущая
vote.delete
Следующая
vote.get