метод REST scope: vote

vote.AttachedVote.recall

Отозвать свой голос

Кто может выполнять: любой пользователь, участвовавший в голосовании

Описание

Метод vote.AttachedVote.recall отзывает голос пользователя в активном голосовании. Метод работает только с теми голосованиями, в которых активна опция Разрешить переголосование.

Параметры

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

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

Идентификатор прикрепленного голосования, получить можно методами vote.AttachedVote.get или vote.AttachedVote.getMany

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.recall

Ответ

HTTP-статус: 200

{
  "result": {
    "attach": {
      "ID": 1,
      "VOTE_ID": 1,
      "COUNTER": 0,
      "QUESTIONS": {
        "1": {
          "ID": "1",
          "ACTIVE": "Y",
          "TIMESTAMP_X": "2025-08-05T09:08:31+03:00",
          "VOTE_ID": "1",
          "C_SORT": "10",
          "COUNTER": 0,
          "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": 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][1]",
              "~PERCENT": 0,
              "PERCENT": 0
            },
            "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": [],
      "canEdit": true,
      "canVote": true,
      "canRevote": true,
      "isVoted": false,
      "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
    }
  },
  "time": {
    "start": 1754461747.345456,
    "finish": 1754461747.393074,
    "duration": 0.04761815071105957,
    "processing": 0.03604316711425781,
    "date_start": "2025-08-06T09:29:07+03:00",
    "date_finish": "2025-08-06T09:29:07+03:00",
    "operating_reset_at": 1754462347,
    "operating": 0
  }
}

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

result object

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

time time

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

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

{
    "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 Нет прав для участия в голосовании

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

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