метод REST

event.unbind

Отменить зарегистрированный обработчик события

Кто может выполнять: любой пользователь

Описание

Метод event.unbind выполняет отмену зарегистрированного обработчика события.

Метод работает только в контексте авторизации приложения. Может работать как при авторизации под пользователем с правами администрирования Битрикс24, так и под обычным пользователем. Метод для пользователя без прав администратора доступен с ограничениями:

  1. Офлайн-события недоступны
  2. Можно удалить только обработчики online-событий, зарегистрированные для текущего пользователя

Параметры

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

Имя события

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

Ссылка на обработчик события

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

Идентификатор пользователя, под которым авторизуется обработчик события.

Если требуется удалить обработчики события, установленные с пустым auth_type (с авторизацией от имени пользователя, вызвавшего событие), но оставить остальные обработчики, указывайте auth_type=0 или пустое значение параметра.

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

Значения: ``online|offline`. По умолчанию event_type=online, и поведение метода не меняется. Если вызывается event_type=offline`, то метод работает с офлайн-событиями

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "event": "ONCRMLEADADD",
    "handler": "https://www.my-domain.ru/handler/",
    "auth": "**put_access_token_here**"
}' \
https://**put_your_bitrix24_address**/rest/event.unbind

Ответ

HTTP-статус: 200

{
    "result": {
        "count": 1
    },
    "time": {
        "start": 1721298360.468008,
        "finish": 1721298360.553977,
        "duration": 0.0859689712524414,
        "processing": 0.0023431777954101562,
        "date_start": "2024-07-18T12:26:00+02:00",
        "date_finish": "2024-07-18T12:26:00+02:00",
        "operating": 0
    }
}

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

result object

Корневой элемент ответа

time time

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

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

HTTP-статус: 403

{
    "error": "ACCESS_DENIED",
    "error_description": "Access denied! Offline events unbinding requires administrator access rights"
}
Код Описание Значение
403 ACCESS_DENIED Access denied! Offline events unbinding requires administrator access rights
403 ACCESS_DENIED Access denied! Event unbinding with AUTH_TYPE requires administrator access rights

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

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