Сколько запросов в секунду можно отправлять к REST API Битрикс24?

Стандартное ограничение — 2 запроса в секунду на один метод. Для массовых операций используйте batch — он позволяет объединить до 50 вызовов в один запрос.

Чем входящий вебхук отличается от OAuth-токена?

Вебхук — быстрый способ авторизации с токеном в URL, подходит для внутренних интеграций. OAuth — полноценный протокол с рефреш-токенами, обязателен для публичных приложений и маркетплейса.

Можно ли через API Битрикс24 работать с файлами?

Да, для этого есть методы с суффиксом file или поля типа FILE_ID . Файлы передаются в base64-кодировке, размер ограничен настройками портала.

Что делать, если метод возвращает QUERY_LIMIT_EXCEEDED?

Ввести задержку между запросами (например, 500 мс) или объединить вызовы в batch . Если лимит превышается системно — проверьте, не запущено ли несколько скриптов параллельно.

Где искать актуальный список методов REST API?

В официальной документации на dev.1c-bitrix.ru/rest_help/ и в api-reference . Для REST 3.0 доступна OpenAPI-спецификация для автогенерации клиентов.

Bitrix24 API: как устроен REST API и с чего начать интеграцию

Когда бизнес перерастает ручное ведение CRM, встаёт вопрос синхронизации: сайт, телефония, задачи, отчёты. Bitrix24 API закрывает большинство таких сценариев. Но у новичков возникает путаница: какие методы вызывать, как авторизоваться и почему одни запросы работают, а другие возвращают ошибку.

Разберу REST API Битрикс24 с практической стороны: от первого запроса до типичных ошибок интеграции. Без воды, только то, что нужно разработчику или техническому специалисту. Покажу, как сделать first-rest-api-call и настроить access-to-rest-api.

Что такое Bitrix24 API и какие задачи он решает

Bitrix24 API — это набор HTTP-методов для доступа к сущностям системы: CRM, задачи, пользователи, компании, контакты, лиды, бизнес-процессы. Через API можно создавать, читать, обновлять и удалять записи, а также подписываться на события системы через вебхуки.

Типичные сценарии, которые закрывает API Битрикс24:

Синхронизация сайта и CRM — передача лидов из форм, интернет-магазинов, лендингов.
Интеграция с телефонией — автоматическое создание карточек звонков, запись разговоров.
Автоматизация задач — создание задач по триггерам, обновление статусов, назначение исполнителей.
Выгрузка отчётов — получение данных по сделкам, воронкам, сотрудникам для аналитики.
Кастомные интеграции — связка с 1С, складскими системами, маркетплейсами.
Если у вас типовой сайт на 1C-Bitrix и нужно передать заявку в CRM — достаточно одного метода crm.lead.add. Если речь о сложной интеграции с десятками сценариев — понадобится продуманная архитектура запросов и обработка ошибок.

битрикс апи

Как устроен REST API Битрикс24

REST API Битрикс24 работает по стандартной HTTP-схеме: клиент отправляет запрос на endpoint, сервер возвращает JSON-ответ. Базовый URL выглядит так: https://ваш_портал.bitrix24.ru/rest/. Для доступа к методам REST API используйте https-протокол.

Например, вызов метода crm.lead.get через GET-запрос:

Ответ приходит в формате JSON. Успешный вызов возвращает result, ошибка — error и error_description.

Авторизация: вебхуки и OAuth-токены

Есть два способа авторизации в REST API Битрикс24:

Способ	Когда использовать	Особенности
Входящий вебхук	Быстрые интеграции, внутренние скрипты	Токен в URL, не требует OAuth, настраивается в интерфейсе за 2 минуты
OAuth-токен	Внешние приложения, маркетплейс, публичные сервисы	Полный цикл авторизации, рефреш-токены, права доступа

Входящий вебхук подходит, когда интеграцию делаете вы или ваш подрядчик, и доступ нужен только к определённым методам, например при разработке сайтов с передачей заявок. OAuth — обязателен, если приложение будут устанавливать другие пользователи Битрикс24.

Первый запрос: с чего начать

Самый простой способ проверить доступ — вызвать метод app.info или user.current. Через браузер это выглядит так:

Если в ответе видите данные пользователя — доступ работает. Дальше можно переходить к методам CRM, чтобы настроить продвижение сайтов на основе данных из лидов.

Для массивов и вложенных структур используйте POST с JSON-телом. Например, создание лида:

код

GET подходит для простых вызовов с параметрами, POST — для передачи сложных структур. Это правило экономит часы отладки.

REST и REST 3.0: в чём разница

У Битрикс24 официально две версии REST API — классический REST и REST 3.0. Они работают параллельно, но отличаются подходом. Обе версии доступны для разработчиков через https://ваш_портал.bitrix24.ru/rest/.

REST (классический) — стабильный набор методов REST API, который развивался годами. Большинство документации и примеров в интернете относится именно к нему. Для работы с классическим REST API Битрикс24 используйте стандартные api call методы.

REST 3.0 — новая версия с автогенерируемой OpenAPI-документацией. Она описывает схемы запросов и ответов машинно-читаемым способом, что упрощает генерацию SDK и проверку типов. Это упрощает how-to-call-rest-api для разработчиков.

Для REST 3.0 доступна OpenAPI-спецификация, которую можно скачать и использовать для автогенерации клиентов. Если вы строите интеграцию с нуля и не привязаны к легаси-коду — присмотритесь к REST 3.0. Если работаете с существующими скриптами — классический REST останется рабочим ещё долго. Подробную информацию о методах REST API ищите в api-reference.

Ключевой момент: не все методы доступны в обеих версиях одинаково. Перед использованием конкретного метода проверяйте его наличие в актуальной документации.

rest api

Где смотреть методы и примеры

Официальная документация — dev.1c-bitrix.ru/rest_help/. Там есть:

список методов по разделам (CRM, задачи, пользователи, бизнес-процессы);
параметры и примеры запросов;
коды ошибок;
описание вебхуков и событий.

Для быстрого поиска методов используйте api-reference — это структурированный справочник, где удобно искать нужный метод по названию. Например, crm.lead., tasks.task., user.get.

Практический совет: перед написанием кода всегда проверяйте метод в песочнице или на тестовом портале. Битрикс24 позволяет создавать бесплатные демо-порталы — это лучший способ отладить интеграцию без риска для боевых данных. Если интеграция нужна для сбора заявок, предварительно стоит провести аудит сайтов, чтобы понять, какие формы и сценарии требуют доработки.

Типичные ошибки и ограничения

Даже опытные разработчики спотыкаются об одни и те же грабли. Вот что встречается чаще всего:

Неверный токен или права доступа. Вебхук может быть ограничен набором методов. Если метод возвращает ALLOW_ONLY_CORS или INVALID_TOKEN — проверьте права вебхука в настройках портала.
Лимиты на количество запросов. У Битрикс24 есть ограничения на частоту вызовов. Для стандартных тарифов это примерно 2 запроса в секунду на метод. Превышение возвращает ошибку QUERY_LIMIT_EXCEEDED. Решение — паузы между запросами или пакетная обработка через batch.
Неверный формат данных. Битрикс24 строг к типам полей. Дата должна быть в формате ISO 8601, телефон — массивом с типом VALUE_TYPE, файлы — base64-строкой. Ошибка INVALID_ARGUMENT чаще всего означает несоответствие схеме.
Игнорирование событий. Если интеграция должна реагировать на изменения в CRM, используйте вебхуки событий (например, ONCRMLEADADD). Это надёжнее, чем опрос портала по таймеру.
Отсутствие обработки ошибок. Сеть нестабильна, Битрикс24 может вернуть 500 или таймаут. Всегда закладывайте повторные попытки и логирование ответов.

Что в итоге

REST API Битрикс24 — рабочий инструмент, который закрывает 90% задач по интеграции CRM с внешними системами. Начните с входящего вебхука и простого метода crm.lead.add — этого достаточно для передачи заявок с сайта. Для сложных сценариев переходите на OAuth, изучайте REST 3.0 и не забывайте про лимиты. Если вам нужна не только интеграция, но и привлечение трафика на сайт, обратите внимание на контекстную рекламу — она хорошо сочетается с автоматизацией обработки лидов. Все методы REST API описаны в api-reference на официальном сайте разработчиков.

Если интеграция с Битрикс24 — лишь часть задачи, а в целом нужен сайт, который приносит заявки, — посмотрите наши услуги по разработке сайтов и проектированию. Мы проектируем и разрабатываем сайты, готовые к интеграции с CRM, а затем продвигаем их в поиске. Если сайт уже есть, но не даёт результата — начните с аудита: разберём 300+ параметров и покажем точки роста.