Коротко: что важно для бизнеса
REST 3.0 начинает покрывать не только технические операции, но и важные бизнес-объекты: формы захвата, товарные данные, складские документы, знания и КЭДО. Это открывает путь к более цельным интеграциям, но не переводит существующие приложения на новые методы автоматически. Особенно рискованны операции записи в каталог, публикация форм и действия со складскими документами: для них нужны права, тестовый контур, журнал и сценарий отката.
Что именно изменилось
21–23 октября Битрикс24 добавил в REST 3.0 методы для Базы знаний 2.0, CRM-форм, товаров и складского учёта, инфоблоков, комментариев Ленты и собственных провайдеров подписи в КЭДО.
- 21 октября появились методы Базы знаний 2.0: получение, перемещение, возврат из архива и корзины документов и коллекций, а также список файлов документа.
- В тот же день добавлен метод log.blogcomment.get для получения опубликованных комментариев Ленты с файлами и постраничной выдачей.
- 22 октября в REST 3.0 добавлены методы crm.form.* для чтения, создания, проверки, изменения, включения и размещения CRM-форм; при включении учитывается лимит активных форм.
- Торговый каталог получил методы для каталогов, разделов, единиц измерения, НДС, цен, типов цен, товаров, вариаций, изображений, складских документов, поставщиков и связанных схем полей.
- В REST 3.0 появились методы форума и чтения элементов инфоблоков со свойствами. Для инфоблока доступ через REST нужно отдельно включить в административной панели.
- 23 октября добавлены методы sign.b2e.provider.* для подключения собственного провайдера подписи в КЭДО; они доступны только приложению с OAuth-авторизацией.
- Июльская версия REST-модуля ранее заложила базовые механизмы REST API v3: идемпотентные запросы, отложенные batch-операции и расширенные OpenAPI-схемы.
Где обновление принесёт пользу — и где не поможет
REST 3.0 начинает покрывать не только технические операции, но и важные бизнес-объекты: формы захвата, товарные данные, складские документы, знания и КЭДО. Это открывает путь к более цельным интеграциям, но не переводит существующие приложения на новые методы автоматически. Особенно рискованны операции записи в каталог, публикация форм и действия со складскими документами: для них нужны права, тестовый контур, журнал и сценарий отката.
Функция принесёт эффект, если у процесса есть владелец, понятный вход, ожидаемый результат и следующий шаг в CRM. Если статусы, права или правила работы не согласованы, автоматизация лишь быстрее воспроизведёт существующую неопределённость.
План безопасного пилота
- Составить перечень объектов, которые интеграция читает и изменяет: формы, товары, цены, остатки, документы, базы знаний, инфоблоки и КЭДО.
- Начать с методов чтения и схем полей на тестовом портале; отдельно проверить OAuth, доступ к инфоблокам и лимит активных CRM-форм.
- Для одной операции записи подготовить контрольные данные, идемпотентный ключ, журнал запроса и способ отмены или ручного исправления результата.
- Сравнить ответ REST 3.0 с интерфейсом Битрикс24 и действующей интеграцией, затем провести повтор запроса и частичный сбой.
- Переводить рабочий обмен по одному объекту, сохраняя старый маршрут и сверку итогов до завершения контрольного периода.
Не меняйте одновременно процесс, интеграции и мотивацию команды: иначе невозможно понять, что повлияло на результат. Для первого цикла достаточно одной группы пользователей и нескольких контрольных примеров.
Как оценить результат без самообмана
Сравнивайте одинаковые показатели на сопоставимых периодах. Если функция принимает решения, отправляет сообщения или меняет данные, сохраните ручное подтверждение до тех пор, пока ошибки не станут понятными и управляемыми.
Короткие ответы
Стоит ли включать обновление сразу для всей команды?
Нет. Сначала проверьте один типовой сценарий и контрольную группу. Масштабировать стоит после того, как понятны ошибки, права доступа и метрика результата.
Что считать успешным результатом?
Не стоит мигрировать всю интеграцию сразу. Выберите один объект и один измеримый маршрут данных, проверьте чтение, запись, повтор, права и откат — только затем расширяйте использование REST 3.0.
Нужна ли отдельная настройка CRM?
Зависит от текущего процесса. Проверьте поля, статусы, ответственных, автоматические действия и права: новая функция не исправит неясный процесс сама по себе.
