метод REST scope: vote

vote.AttachedVote.get

Получить данные прикрепленного голосования

Кто может выполнять: пользователь с правами чтения голосования

Описание

Метод vote.AttachedVote.get возвращает данные прикрепленного голосования.

Параметры

1. Через идентификатор прикрепленного опроса

attachId integer обязательный

Идентификатор прикрепленного голосования, может быть равен voteId из результатов vote.Integration.Im.send

2. Через элемент с опросом

moduleId string обязательный

Идентификатор модуля, возможные значения:
- Im для опроса в чате,
- blog для опроса в ленте

entityType string обязательный

Тип объекта, возможные значения:
- Bitrix\\Vote\\Attachment\\ImMessageConnector для опроса в чате,
- Bitrix\\Vote\\Attachment\\BlogPostConnector для опроса в ленте

entityId integer обязательный

Идентификатор элемента, возможные значения:
- id сообщения чата с опросом, получить можно методом vote.Integration.Im.send,
- id поста с опросом в ленте, получить можно методом log.blogpost.get

3. Через подписанный идентификатор

signedAttachId string обязательный

Подписанный идентификатор прикрепления, получить можно методом vote.AttachedVote.get, параметр ответа signedAttachId

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"attachId":**put_attach_id**}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/vote.AttachedVote.get

Ответ

HTTP-статус: 200

{
  "attach": {
    "ID": 1,
    "VOTE_ID": 1,
    "COUNTER": 1,
    "QUESTIONS": {
      "1": {
        "ID": "1",
        "ACTIVE": "Y",
        "TIMESTAMP_X": "2025-08-05T09:08:31+03:00",
        "VOTE_ID": "1",
        "C_SORT": "10",
        "COUNTER": "1",
        "QUESTION": "Как дела?",
        "QUESTION_TYPE": "text",
        "IMAGE_ID": null,
        "DIAGRAM": "Y",
        "DIAGRAM_TYPE": "histogram",
        "REQUIRED": "N",
        "FIELD_TYPE": "0",
        "FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
        "IMAGE": null,
        "ANSWERS": {
          "1": {
            "ID": "1",
            "ACTIVE": "Y",
            "TIMESTAMP_X": "2025-08-05T09:08:31+03:00",
            "QUESTION_ID": "1",
            "C_SORT": "10",
            "IMAGE_ID": null,
            "MESSAGE": "Отлично!",
            "MESSAGE_TYPE": "text",
            "COUNTER": "1",
            "FIELD_TYPE": "0",
            "FIELD_WIDTH": "0",
            "FIELD_HEIGHT": "0",
            "FIELD_PARAM": null,
            "COLOR": "",
            "REACTION": "",
            "~FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
            "FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
            "MESSAGE_FIELD_NAME": "bx_vote_event[1][MESSAGE][1][1]",
            "~PERCENT": 100,
            "PERCENT": 100
          },
          "3": {
            "ID": "3",
            "ACTIVE": "Y",
            "TIMESTAMP_X": "2025-08-05T09:08:31+03:00",
            "QUESTION_ID": "1",
            "C_SORT": "20",
            "IMAGE_ID": null,
            "MESSAGE": "Лучше всех!",
            "MESSAGE_TYPE": "text",
            "COUNTER": "0",
            "FIELD_TYPE": "0",
            "FIELD_WIDTH": "0",
            "FIELD_HEIGHT": "0",
            "FIELD_PARAM": null,
            "COLOR": "",
            "REACTION": "",
            "~FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
            "FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
            "MESSAGE_FIELD_NAME": "bx_vote_event[1][MESSAGE][1][3]",
            "~PERCENT": 0,
            "PERCENT": 0
          },
          "5": {
            "ID": "5",
            "ACTIVE": "Y",
            "TIMESTAMP_X": "2025-08-05T09:08:31+03:00",
            "QUESTION_ID": "1",
            "C_SORT": "30",
            "IMAGE_ID": null,
            "MESSAGE": "Какие дела??",
            "MESSAGE_TYPE": "text",
            "COUNTER": "0",
            "FIELD_TYPE": "0",
            "FIELD_WIDTH": "0",
            "FIELD_HEIGHT": "0",
            "FIELD_PARAM": null,
            "COLOR": "",
            "REACTION": "",
            "~FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
            "FIELD_NAME": "bx_vote_event[1][BALLOT][1]",
            "MESSAGE_FIELD_NAME": "bx_vote_event[1][MESSAGE][1][5]",
            "~PERCENT": 0,
            "PERCENT": 0
          }
        }
      }
    },
    "ANONYMITY": 1,
    "OPTIONS": 1,
    "userAnswerMap": {
      "1": {
        "1": {
          "EVENT_ID": "1",
          "EVENT_QUESTION_ID": "1",
          "ANSWER_ID": "1",
          "ID": "1",
          "MESSAGE": ""
        }
      }
    },
    "canEdit": true,
    "canVote": false,
    "canRevote": true,
    "isVoted": true,
    "signedAttachId": "1.52280488561bf567f33cf03b5ce353e154a9c3552b51b2ffb67be3bb7f26f986",
    "resultUrl": "/vote-result/me7hn922bm011mbf",
    "downloadUrl": "/bitrix/services/main/ajax.php?action=vote.AttachedVote.download&SITE_ID=s1&signedAttachId=1.52280488561bf567f33cf03b5ce353e154a9c3552b51b2ffb67be3bb7f26f986",
    "entityId": 13,
    "isFinished": false
  }
}

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

result object

Корневой элемент ответа. Содержит объект attach с информацией о прикрепленном голосовании, структура описана ниже

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "ATTACH_NOT_FOUND",
    "error_description": "Attach not found"
}
Код Описание Значение
100 Bitrix\Vote\Attach All parameters in the constructor must have real class type Не передан или некорректен обязательный параметр. Передайте attachId, signedAttachId либо связку moduleId + entityType + entityId
ATTACH_NOT_FOUND Attach not found Голосование не найдено
ATTACH_READ_ACCESS_DENIED Attach read access denied Нет прав для участия в голосовании

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.