REST API разработка

REST API для Битрикс24

Свяжем Битрикс24 с любой внешней системой через REST API: сайт, 1С, телефония, банк, маркетплейсы, BI. Разработаем методы, вебхуки, очереди и документацию. Данные синхронизируются автоматически — без ручного переноса и Excel. Под ключ: от проектирования до поддержки.

50 000 ₽

Стартовая цена

2–6

недель

0

ручных переносов

REST API для Битрикс24

Любая система — в одной CRM

Почему API решает задачи интеграции

8 причин разработать REST API для Битрикс24

Любая система

Сайт, 1С, телефония, банк, маркетплейсы, BI, ERP — подключаем через API. Нет ограничений по вендору .

Автоматическая синхронизация

Данные передаются в реальном времени или по расписанию. Без ручного переноса и Excel .

Кастомные методы

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

Безопасность

OAuth, вебхуки, ограничение доступа по IP, шифрование. Данные не уходят третьим лицам.

Производительность

Очереди, кэширование, порционная передача. Даже большие объёмы данных не тормозят CRM .

Документация

OpenAPI/Swagger, описание методов, примеры запросов. Ваши разработчики смогут поддерживать интеграцию.

Тестирование

Проверяем на тестовой копии, нагрузочные тесты, обработка ошибок.

Поддержка после запуска

Мониторим API, обновляем при изменениях, дорабатываем методы под новые задачи.

Что входит в разработку REST API

42 направления — от методов и вебхуков до документации и AI

Разработка REST API

Методы для работы с CRM

  • CRUD
  • Методы
  • Логика
  • Тесты
Интеграция с сайтом

Заявки, формы, личный кабинет

  • Формы
  • Заявки
  • Кабинет
  • UTM
Интеграция с 1С

Товары, заказы, оплаты, документы

  • Товары
  • Заказы
  • Оплаты
  • Документы
Интеграция с телефонией

Звонки, записи, карточки

  • Звонки
  • Записи
  • Карточки
  • История
Интеграция с маркетплейсами

Ozon, WB, Яндекс.Маркет

  • Заказы
  • Остатки
  • Цены
  • Карточки
Интеграция с банками

Выписки, платёжки, сверка

  • Выписки
  • Платёжки
  • Сверка
  • Уведомления
Интеграция с BI

Yandex DataLens, Visiology, Power BI

  • DataLens
  • Visiology
  • Power BI
  • Данные
Интеграция с Jira

Задачи и проекты

  • Задачи
  • Проекты
  • Статусы
  • Комментарии
Интеграция с Git

GitHub, GitLab, Bitbucket

  • GitHub
  • GitLab
  • Коммиты
  • Ветки
Интеграция с AI

YandexGPT, GigaChat, BitrixGPT

  • YandexGPT
  • GigaChat
  • BitrixGPT
  • Сценарии
Интеграция с хостингом

Мониторинг, бэкапы, алерты

  • Мониторинг
  • Бэкапы
  • Алерты
  • Логи
Авторизация и доступ

OAuth, вебхуки, права

  • OAuth
  • Вебхуки
  • Права
  • IP
Вебхуки

События из CRM во внешние системы

  • События
  • HTTP
  • Очередь
  • Ретраи
Очереди и ретраи

Надёжная доставка данных

  • Очереди
  • Ретраи
  • Логи
  • Мониторинг
Производительность

Оптимизация и кэширование

  • Кэш
  • Порции
  • Индексы
  • Нагрузка
Документация

OpenAPI, Swagger, примеры

  • OpenAPI
  • Swagger
  • Примеры
  • Postman
Тестирование

Тесты и нагрузка

  • Unit
  • Интеграция
  • Нагрузка
  • Ошибки
Безопасность

Шифрование, подписи, логи

  • Шифрование
  • Подписи
  • Логи
  • Аудит
Мониторинг API

Логи, алерты, метрики

  • Логи
  • Алерты
  • Метрики
  • Дашборды
Миграция данных

Перенос через API

  • Импорт
  • Экспорт
  • Проверка
  • История
Двусторонняя синхронизация

Обмен в обе стороны

  • Синхронизация
  • Правила
  • Конфликты
  • Логи
Автоматизация через API

Роботы и триггеры

  • Роботы
  • Триггеры
  • Сценарии
  • Тесты
Мобильные приложения

API для мобильных приложений

  • iOS
  • Android
  • API
  • Push
Обучение разработчиков

Как работать с API

  • Документация
  • Примеры
  • Воркшопы
  • Поддержка
Регламенты

Документация по API

  • Регламенты
  • Инструкции
  • Схемы
  • Сроки
Техподдержка

Сопровождение API

  • Консультации
  • Исправления
  • Обновления
  • Мониторинг
Доработки

Новые методы и интеграции

  • Методы
  • Интеграции
  • Роботы
  • Отчёты
Кастомные сценарии

Нестандартные интеграции

  • Логика
  • Разработка
  • Тесты
  • Отчёты
SLA по API

Сроки реакции и доступность

  • SLA
  • Доступность
  • Эскалация
  • Отчёты
Ограничение запросов

Лимиты и квоты

  • Лимиты
  • Квоты
  • Очереди
  • Уведомления
Выгрузка данных

Экспорт через API

  • Excel
  • CSV
  • JSON
  • Отчёты
Импорт данных

Загрузка через API

  • JSON
  • CSV
  • Excel
  • Проверка
Аудит API

Проверка текущих интеграций

  • Аудит
  • Ошибки
  • Рекомендации
  • План
Сквозная аналитика

Данные для BI и отчётов

  • Данные
  • BI
  • Отчёты
  • ROI
Настройка прав

Доступ к API по ролям

  • Роли
  • Права
  • Доступ
  • Аудит
Маршрутизация данных

Куда и что передавать

  • Правила
  • Условия
  • Очереди
  • Логи
Планирование обмена

Расписание синхронизации

  • Расписание
  • События
  • Окна
  • Мониторинг
История запросов

Логи API

  • Логи
  • История
  • Ошибки
  • Отчёты
MCP Hub

Подключение внешних сервисов

  • Сервисы
  • Данные
  • AI
  • Интеграции
AI-интеграции

AI через API

  • AI
  • Сценарии
  • Данные
  • Ответы
Интеграция с внешними API

Сторонние сервисы

  • REST
  • OAuth
  • Webhooks
  • Очереди
Версионирование API

Поддержка версий

  • Версии
  • Совместимость
  • Документация
  • Миграция

Как мы разрабатываем API

Прозрачный процесс от аудита до поддержки

1
Аудит

Смотрим, какие системы нужно связать, какие данные передавать, какая нагрузка ожидается.

2
Проектирование

Определяем методы, форматы, авторизацию, вебхуки. Согласовываем архитектуру.

3
Разработка

Пишем код, настраиваем окружение, подключаем тестовую копию.

4
Документация

Описываем методы в OpenAPI/Swagger, готовим примеры для разработчиков .

5
Тестирование

Проверяем каждый метод, нагрузку, обработку ошибок.

6
Запуск

Внедряем в боевую систему, мониторим первые дни.

7
Обучение

Показываем разработчикам, как работать с API, где смотреть логи.

8
Поддержка

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

Стоимость разработки

Ориентировочные цены по рынку 2027 года. Точный расчёт — после аудита.

Базовый
от 50 000 ₽

Простое API

  • 3–5 методов
  • Базовая авторизация
  • Документация
  • Тестирование
  • Обучение (2 часа)
  • 1 месяц поддержки
Заказать
ХИТ
Стандартный
от 120 000 ₽

Интеграция двух систем

  • Всё из «Базовый»
  • До 15 методов
  • Вебхуки
  • Очереди и ретраи
  • OpenAPI/Swagger
  • Обучение (4 часа)
  • 3 месяца поддержки
Заказать
Комплексный
от 250 000 ₽

Несколько систем

  • Всё из «Стандартный»
  • Неограниченные методы
  • OAuth и доступы
  • Мониторинг и алерты
  • Нагрузочные тесты
  • Обучение (8 часов)
  • 6 месяцев поддержки
Заказать

* Цены указаны за услуги интегратора. По рынку разработка REST API — от 50 000 ₽ до 300 000 ₽ в зависимости от сложности. Часовая ставка разработчика — 2 500–5 000 ₽/час. Точный расчёт — после аудита.

Наши проекты

Примеры разработки API и интеграций

Интернет-магазин

API для связи сайта с 1С и CRM. Заказы, остатки, цены синхронизируются в реальном времени. Менеджеры видят актуальные данные.

E-commerce 1С
Производственная компания

API для интеграции 1С:УПП и CRM. Заказы, спецификации, статусы производства. Ручной перенос данных исключён.

Производство 1С:УПП
Медицинская клиника

API для связи МИС и CRM. Расписание врачей, пациенты, записи. Администраторы не дублируют данные.

Медицина МИС
Логистическая компания

API для GPS-мониторинга и CRM. Статусы рейсов и местоположение транспорта видны менеджерам и клиентам.

Логистика GPS
Агентство недвижимости

API для интеграции с Avito и ЦИАН. Заявки создаются в CRM автоматически, с указанием источника и объекта.

Недвижимость Avito
Маркетплейсы

API для Ozon, WB и Яндекс.Маркет. Заказы, остатки, цены — в одной CRM. Без overselling.

Маркетплейсы Ozon + WB

REST API в цифрах

Что даёт разработка API

0

ручных переносов

Данные синхронизируются автоматически. Без Excel и копирования между системами .

2–6

недель на запуск

Срок от аудита до работающего API. Зависит от количества методов и систем.

50 000 ₽

стартовая цена

Простое API: 3–5 методов, документация, тесты .

100+

методов

Разработано методов для интеграций с сайтами, 1С, телефонией, маркетплейсами.

Данные живут в разных системах и не синхронизируются?

Сайт, 1С, телефония, маркетплейсы — каждая система работает отдельно. Менеджеры вручную переносят заказы, остатки не сходятся, ошибки накапливаются. Разработаем REST API для Битрикс24: методы, вебхуки, очереди, документация. Данные синхронизируются автоматически — без Excel и ручного труда. Бесплатный аудит и предварительная смета.

Нажимая кнопку, вы соглашаетесь на обработку персональных данных в соответствии с политикой конфиденциальности.

Часто задаваемые вопросы о REST API Битрикс24

Развёрнутые ответы на популярные вопросы о вебхуках, REST 3.0, лимитах и разработке интеграций

REST API — это интерфейс, через который внешние системы обмениваются данными с Битрикс24. С его помощью можно создавать сделки, читать контакты, обновлять задачи, получать отчёты — всё, что доступно в интерфейсе, можно сделать программно.

Зачем нужен. Стандартных интеграций в Маркетплейсе много, но они покрывают типовые сценарии. Если у вас нестандартная система (самописная CRM, внутренний портал, специфический сервис), API — это способ связать её с Битрикс24 без ручного переноса данных.

В 2027 году REST API Битрикс24 работает в двух версиях: старая версия и REST 3.0. Они работают параллельно, методы CRM переведены на новый формат.

REST 3.0 — это обновлённая версия API, которая работает параллельно со старой.

Что изменилось. Методы CRM переведены на новый формат: crm.deal.add существует и в старой версии, и в REST 3.0. Версия определяется адресом вызова: /rest/ — старая версия, /rest/api/ — REST 3.0 .

Что важно. В REST 3.0 другой формат batch-запросов: подзапросы передаются как JSON-массив объектов, а не строки вида method?param=value.

Что пока не переведено. Таймлайн, генератор документов, автоматизация и некоторые другие разделы CRM пока работают только в старой версии.

Это два способа авторизации для доступа к API.

Вебхук — простой URL с токеном, который даёт доступ к API от имени пользователя, создавшего вебхук. Настройка занимает минуту, не требует регистрации приложения. Подходит для быстрых интеграций, скриптов, тестов.

OAuth 2.0 — полноценная авторизация, при которой приложение получает токен от имени пользователя через согласие. Подходит для приложений, которые будут использовать другие люди или компании. Позволяет обновлять токены, управлять правами, работать в Маркетплейсе.

Для внутренних скриптов и небольших интеграций достаточно вебхука. Для приложений, которые распространяются, — OAuth 2.0.

Лимиты защищают систему от перегрузки. В 2027 году действуют ограничения на интенсивность и время выполнения.

Лимит интенсивности. Работает по принципу Leaky Bucket. Для тарифа Энтерпрайз — 5 запросов в секунду, лимит до блокировки 250. Для прочих тарифов — 2 запроса в секунду, лимит до блокировки 50.

Время выполнения. Один REST-запрос в облачной версии должен выполняться не дольше 60 секунд.

Важно для тарифов. В тарифах Essentials (с 2027 года) REST API отсутствует. Для интеграций через API нужен тариф Vibe+, где REST API безлимитный.

Batch — это метод, который позволяет отправить несколько вызовов API в одном HTTP-запросе.

Зачем нужен. Лимит интенсивности учитывает HTTP-запросы, а не количество вызовов внутри. Batch передаёт до 50 вызовов в одном запросе, поэтому расходует лимит как один запрос .

Что важно в REST 3.0. Формат batch изменился: подзапросы передаются как JSON-массив объектов, а не строки вида method?param=value.

Ограничение. Batch сокращает число HTTP-запросов, но не уменьшает ресурсоёмкость методов внутри пакета. Если каждый вызов тяжёлый, batch не спасёт от таймаута .

Да, это одна из самых частых задач. В REST 3.0 методы CRM работают с элементами и их окружением: поля, воронки, стадии, товарные позиции, реквизиты, адреса, дела .

Пример. Внешняя система создаёт заявку и через API создаёт сделку в Битрикс24 с полным набором полей: клиент, сумма, товары, источник, UTM-метки.

Что важно. Без параметра select методы get и list возвращают только id. Нужно явно перечислить поля, которые хотите получить .

Имена методов пишутся в нижнем регистре: crm.deal.add, а не crm.Deal.add.

В REST 3.0 смарт-процессы поддерживаются. Имя метода включает тип объекта: crm.smartprocess1038.add, где 1038 — идентификатор типа смарт-процесса .

Как узнать ID типа. Метод crm.type.list возвращает список типов смарт-процессов. В REST 3.0 аналога этого метода нет, вызывайте его по адресу старой версии /rest/ .

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

Ошибки можно разделить на несколько категорий.

Ошибки валидации. Параметры не прошли проверку. Код BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION, в ответе массив validation с указанием полей.

Ошибки доступа. У вебхука или приложения нет нужного скоупа. Код BITRIX_REST_V3_EXCEPTION_INSUFFICIENTSCOPEEXCEPTION.

Ошибки лимитов. Превышена интенсивность запросов. Код QUERY_LIMIT_EXCEEDED, статус 503. Нужно повторить с задержкой.

Ошибки таймаута. Запрос выполнялся дольше 60 секунд. Код OPERATION_TIME_LIMIT .

Для больших выборок нужно использовать постраничную загрузку.

Рекомендация. Передавайте start = -1 и переходите к следующей странице фильтром по последнему полученному идентификатору. Это позволяет не считать общее количество элементов .

Почему это важно. Подсчёт общего количества может быть тяжёлым для больших таблиц. Постраничная загрузка без подсчёта работает быстрее и стабильнее.

Лимит интенсивности. При 2 запросах в секунду и размере страницы 50 записей за сутки можно получить до 8 640 000 записей.

Да, API позволяет загружать файлы на диск Битрикс24, прикреплять их к сделкам, задачам, контактам.

Что можно делать: загрузить файл, получить ссылку на скачивание, прикрепить к сущности, удалить файл.

Ограничения. Есть лимит на размер файла (зависит от тарифа и настроек сервера). Для больших файлов лучше использовать по частям или через отдельные сервисы хранения.

В REST 3.0 работа с файлами и документами также поддерживается, но некоторые разделы (например, генератор документов) пока работают только в старой версии.

В REST 3.0 задачи поддерживаются. Методы позволяют создавать и изменять задачи, работать с чатом задачи, результатами, файлами и правами доступа.

Пример. Внешняя система создаёт задачу в Битрикс24, назначает ответственного, устанавливает срок, добавляет описание. Сотрудник видит задачу в портале.

Обратная связь тоже работает: когда задача завершена, API может отправить уведомление во внешнюю систему.

API позволяет создавать пользователей, обновлять их данные, управлять правами.

Зачем это нужно. Для синхронизации с HR-системой или корпоративным каталогом. При приёме сотрудника пользователь создаётся автоматически, при увольнении — блокируется.

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

В 2027 году появился системный пользователь — служебная учётная запись, которая автоматически создаётся при установке приложения из Маркетплейса или при увольнении сотрудника с активными интеграциями. Это обеспечивает непрерывность работы интеграций.

Да, API позволяет регистрировать звонки в CRM: создавать записи о звонках, привязывать к сделкам и контактам, сохранять записи разговоров.

Пример. Телефонная станция после завершения звонка отправляет данные в Битрикс24: номер, длительность, запись, ответственного. Сделка обновляется.

Также можно получать данные о звонках для отчётов: количество, длительность, пропущенные.

Да, это одна из самых частых интеграций. Через API можно передавать товары, цены, остатки, контрагентов, заказы, счета, оплаты.

Схема. Из 1С в CRM передаются товары и цены, из CRM в 1С — заказы и оплаты. Это позволяет менеджерам работать в CRM, а бухгалтерии — в 1С.

Настройка. Через готовый модуль обмена (для типовых конфигураций) или кастомную интеграцию через API (для нестандартных).

В 2027 году добавилась возможность подключить ЭДО с 1С-Битрикс для обмена документами.

API позволяет запускать бизнес-процессы, получать их статусы, завершать задачи.

Пример. Внешняя система документооборота запускает процесс согласования в Битрикс24, получает статусы, завершает процесс.

Что важно. В REST 3.0 автоматизация и бизнес-процессы пока не переведены на новый формат — они работают только в старой версии API.

Безопасность — это комплекс мер.

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

Хранение токенов. Токены не должны храниться в открытом виде в коде или репозитории. Используйте переменные окружения или секретные хранилища.

HTTPS. Все запросы должны идти по защищённому протоколу.

Логирование. Все запросы и ответы должны логироваться.

Ротация токенов. Периодически меняйте токены, особенно если есть подозрение на утечку.

Тестирование должно быть на всех уровнях.

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

Тестовые данные. Создайте несколько тестовых сделок, контактов, задач. Проверьте, что данные корректно создаются, обновляются, удаляются.

Граничные случаи. Проверьте, что происходит при пустых полях, больших объёмах, ошибках сети.

Нагрузка. Если планируется много запросов, проверьте, как система справляется с нагрузкой. Помните про лимиты.

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

Исходящий вебхук — механизм, при котором Битрикс24 сам отправляет данные во внешнюю систему по событию. Например, когда сделка меняет стадию, отправляется запрос на указанный URL.

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

API позволяет создавать события в календаре, обновлять их, получать список событий, приглашать участников.

Пример. Внешняя система создаёт запись и синхронизирует её с календарём сотрудника в Битрикс24.

Также можно синхронизировать календарь с Google Calendar или Яндекс.Календарём.

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

Чаще всего через API выгружают сырые данные и строят отчёты во внешней системе (BI, Excel, Google Sheets).

Для типовых отчётов можно использовать методы, которые возвращают агрегированные данные. Но для сложной аналитики лучше выгружать сделки и строить отчёты самостоятельно.

Зависит от сложности.

Простая интеграция (создание сделки из формы на сайте) — 1–3 дня.

Средняя (двусторонний обмен с 1С, синхронизация контактов) — 1–2 недели.

Сложная (интеграция с несколькими системами, обработка ошибок, очереди) — от 3 недель до нескольких месяцев.

Сроки зависят от качества документации, готовности API на стороне внешней системы, сложности маппинга полей.

Документация — это не формальность, а необходимость.

Что должно быть в документации: схема обмена, маппинг полей, список методов API, обработка ошибок, логирование и мониторинг, контакты ответственных.

Хорошая документация экономит время при доработках и передаче проекта.

В REST 3.0 есть автоматически генерируемая OpenAPI-документация. Её можно получить, вызвав метод rest.documentation.openapi.

Да, и в коробке API даже гибче, чем в облаке. Нет ограничений на количество запросов, которые есть в облачных тарифах. Лимиты зависят от настроек сервера.

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

Важное изменение 2027 года. В облачных тарифах появились варианты Essentials и Vibe+. В Essentials REST API отсутствует. В коробке такого разделения нет — API доступен всегда.

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

Шаги: определите тип объекта и имя метода; узнайте поля типа; создайте тестовый вебхук с минимальными правами; проверьте на тестовых данных; разработайте интеграцию, тестируйте, запустите, документируйте.

Оставьте заявку на сайте или позвоните: 8 (920) 654-75-95. Проведём бесплатный аудит и предложим план интеграции под ваши задачи.

Статьи об API

Полезные материалы о разработке REST API для Битрикс24

Методы
Методы REST API в Битрикс24: что можно и что нельзя

Какие сущности доступны через API, какие ограничения, как обходить лимиты .

Читать →
Вебхуки
Вебхуки: как получать события из CRM

Настройка, безопасность, обработка ошибок. Когда вебхуки лучше опроса .

Читать →
Безопасность
Авторизация в API: OAuth, вебхуки, права

Как настроить доступ безопасно и не открыть данные лишним .

Читать →
Надёжность
Очереди и ретраи: как не терять данные при сбоях

Что делать, если внешняя система недоступна. Как настроить надёжный обмен .

Читать →
Документация
Документация API: зачем нужна и как писать

OpenAPI, Swagger, примеры запросов. Почему без документации интеграция умирает .

Читать →
Ошибки
5 ошибок при разработке API

Отсутствие ретраев, неверная авторизация, нет логирования — как исправить.

Читать →

Остались вопросы? Закажите консультацию

Наш специалист свяжется с вами и бесплатно проконсультирует по всем вопросам. Без навязчивых звонков и спама.

Нажимая кнопку, вы соглашаетесь на обработку персональных данных в соответствии с политикой конфиденциальности.

* Необязательное поле

Загрузка...

Заказать
звонок
Заказать обратный звонок
Получите консультацию уже сегодня.
Наш специалист свяжется с вами и абсолютно бесплатно проконсультирует по всем вопросам.
Данные отправлены. Вам скоро перезвонят.
Жду звонка