rest api битрикс24: что можно сделать без коробки

что такое REST API Битрикс24

REST API — это интерфейс, через который внешние программы могут взаимодействовать с Битрикс24: читать и создавать данные (сделки, контакты, задачи), получать уведомления о событиях (изменение сделки, новое сообщение), выполнять действия (запустить робота, отправить письмо). Доступен и в Облаке, и в Коробке. В отличие от Коробки, где вы имеете полный доступ к базе, API работает через методы (запросы), что более безопасно и удобно для внешних интеграций.

основные сущности, с которыми работает API

CRM: лиды, сделки, контакты, компании, счета, катaлог товаров, воронки, стадии.
Задачи и проекты: задачи, проекты, чек-листы, комментарии.
Пользователи: сотрудники, отделы, права доступа.
Файлы и документы: загрузка, скачивание, генерация из шаблонов.
Календарь: события, встречи.
Чат и открытые линии: отправка сообщений, работа с диалогами.
Бизнес-процессы: запуск, работа с шагами.
Всего 200+ методов API для работы с 50+ типами сущностей.

способы авторизации

Входящие вебхуки. Простой способ для быстрой интеграции. В настройках Битрикс24 создаёте вебхук, получаете URL. Через него внешние системы могут вызывать методы API. Плюс: 5 минут настройки. Минус: неограниченный доступ (лучше не давать сторонним компаниям).
Исходящие вебхуки. Битрикс24 сам вызывает URL внешней системы при определённых событиях (новая сделка, изменение статуса).
OAuth 2.0. Для полноценных приложений в маркетплейсе. Пользователь явно даёт разрешения приложению. Более безопасный, но сложнее настройка.
Для внутренних задач компании — обычно вебхуки. Для приложений в маркетплейсе — OAuth.

события: получение уведомлений

Помимо запросов данных, API позволяет подписаться на события Битрикс24. Когда происходит событие (новая сделка, изменение статуса, входящий звонок) — Битрикс24 отправляет уведомление на URL, который вы указали.
Основные события: ONCRMDEALADD (новая сделка), ONCRMDEALUPDATE (изменение сделки), ONCRMLEADADD (новый лид), ONTASKADD (новая задача), ONIMOPENLINESMESSAGE (новое сообщение в открытых линиях).
Практическое применение: синхронизация с внешней системой в реальном времени, мгновенное уведомление о ключевых событиях, автоматизация цепочек между разными системами.

что реально построить через API

Синхронизацию с внешней системой. С 1С, ERP, самописной системой учёта.
Персональный дашборд. Забрать данные из Битрикс24, показать в удобном виде (Google Sheets, PowerBI).
Свой личный кабинет клиента. Клиент видит свои сделки, историю заказов, оплаты — на вашем сайте, данные из Битрикс24.
Интеграцию с сайтом. Заявки с сайта — в CRM, статусы обратно на сайт.
Работу с чат-ботами. Бот в Telegram/WhatsApp через API работает с Битрикс24: создаёт сделки, отвечает на вопросы.
Массовые операции. Импорт больших объёмов данных, массовое обновление, отчёты по всем сделкам.
См. также — Битрикс24 «Вайбкод»: программирование без разработчика.

ограничения API

Лимиты запросов. В Облаке — до 2 запросов/сек. Больше — блокировка на несколько минут. При массовых операциях — надо соблюдать паузы.
Не все сущности через API. Например, работа с некоторыми специфическими настройками портала — только через интерфейс.
Разница между Облаком и Коробкой. API одинаков в 95% случаев, но некоторые методы могут различаться. В Коробке дополнительно есть прямой доступ к базе (при наличии).
Обновления API. Битрикс24 регулярно добавляет и меняет методы. Старые обычно поддерживаются годами, но иногда меняются.

с чего начать

1. Изучить документацию — dev.1c-bitrix.ru. Отдельный раздел «REST API».
2. Создать тестовый портал Битрикс24 (Free-тариф) для экспериментов.
3. Создать входящий вебхук, попробовать простые методы (получить список сделок, создать сделку).
4. Написать простое приложение (например, скрипт на Python или Node.js), которое читает данные из Битрикс24.
5. Постепенно усложнять — работать с событиями, OAuth, публиковать приложение в маркетплейсе.
Полноценное освоение — 2–4 недели работы для человека с опытом веб-разработки. См. про разработку приложения.

частые вопросы