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

Зарегистрировать новый обработчик события event.bind

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

Метод event.bind регистрирует новый обработчик события.

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

1. Офлайн-события недоступны, попытка установки будет порождать исключение
2. События устанавливаются от имени текущего пользователя (см. описание параметра auth_type). Явное указание auth_type, отличного от ID текущего пользователя, также будет порождать исключение

Интерфейс для данного метода — BX24.callBind.

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

Примеры кода

• 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.bind

• JS

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

• PHP

    require_once('crest.php');

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

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

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

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1721296536.908506,
        "finish": 1721296537.007365,
        "duration": 0.09885907173156738,
        "processing": 0.03251290321350098,
        "date_start": "2024-07-18T11:55:36+02:00",
        "date_finish": "2024-07-18T11:55:37+02:00",
        "operating": 0
    }
}

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

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

HTTP-статус: 400

{
    "error":"ERROR_EVENT_NOT_FOUND",
    "error_description":"Event not found"
}

Возможные коды ошибок

• [](./events)
• [](./event-get)
• [](./event-unbind)
• [](./safe-event-handlers)
• [](./offline-events)
• [](./event-offline-list)
• [](./event-offline-get)
• [](./event-offline-clear)
• [](./event-offline-error)
• [](./on-offline-event)
• [](../../tutorials/openlines/example-connector)s