Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Отменить зарегистрированный обработчик события event.unbind». Вы узнаете экспертные методики работы с отменить зарегистрированный и научитесь избегать типичных ошибок начинающих разработчиков.

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

> Кто может выполнять метод: администратор

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

Метод работает только в контексте авторизации приложения и только при авторизации под пользователем с правами администрирования портала.

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

Если какие-либо параметры не указаны, то будут удалены все обработчики события, удовлетворяющие остальным требованиям.

Примеры кода

• cURL (OAuth)

    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

• JS

    BX24.callUnbind(
        'ONCRMLEADADD',
        'https://www.my-domain.ru/handler/',
        15,
        (result) => console.log(result)
    );

• PHP

    require_once('crest.php');

    $result = CRest::call(
        'event.unbind',
        [
            'EVENT' => 'ONCRMLEADADD',
            'HANDLER' => 'https://www.my-domain.ru/handler/',
            'AUTH_TYPE' => 15
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

• PHP (B24PhpSdk)

    try {
        $eventCode = 'your_event_code'; // Replace with your actual event code
        $handlerUrl = 'https://your.handler.url'; // Replace with your actual handler URL
        $userId = null; // Replace with your actual user ID or leave as null
        $result = $serviceBuilder
            ->getMainScope()
            ->event()
            ->unbind($eventCode, $handlerUrl, $userId);
        print($result->getUnbindedHandlersCount());
    } catch (Throwable $e) {
        print('Error: ' . $e->getMessage());
    }

Обработка ответа

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
    }
}

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

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

Смотрите также

• [](../../sdk/bx24-js-sdk/how-to-call-rest-methods/bx24-call-unbind)

• [](./events)
• [](./event-bind)
• [](./event-get)
• [](./safe-event-handlers)
• [](./offline-events)
• [](./event-offline-list)
• [](./event-offline-get)
• [](./event-offline-clear)
• [](./event-offline-error)
• [](./on-offline-event)