Оглавление
В этой статье описано, как приложение REST-Активити обрабатывает запросы, которые запускаются из бизнес-процессов Битрикс24, и что происходит, если при выполнении запроса срабатывает ограничение по лимиту.
Как обрабатывается запрос из бизнес-процесса
Когда в бизнес-процессе выполняется действие REST-Активити, приложение получает запрос, обрабатывает его и возвращает результат обратно в бизнес-процесс.
После получения ответа бизнес-процесс продолжает выполнение по настроенной в нем логике. Например, он может записать полученные данные в поле, перейти к следующему действию, выполнить условие или завершиться.
Если запрос находится в очереди, его статус можно проверить в приложении. Подробнее об очереди и статистике запросов написано в статье Статистика и очередь запросов.
Что происходит, если исчерпан лимит запросов
В базовой версии REST-Активити количество обращений к приложению ограничено. Если лимит исчерпан, новый запрос из бизнес-процесса не ставится в очередь для последующей обработки.
Вместо этого бизнес-процесс получает от приложения ответ о том, что лимит превышен. После получения такого ответа бизнес-процесс продолжает выполнение по своей текущей настройке.
Это важно учитывать: бизнес-процесс не ожидает автоматического снятия лимита и не выполняет этот же запрос повторно сам по себе.
Нужно ли перезапускать бизнес-процессы после покупки расширенной версии
Если после исчерпания лимита была куплена расширенная версия REST-Активити, ограничение на новые запросы снимается. Однако уже выполненные бизнес-процессы не запускаются повторно автоматически.
Если бизнес-процесс уже получил ответ о превышении лимита и завершился без нужного действия, его нужно запустить повторно вручную.
Если бизнес-процесс находится в статусе ожидания ответа от приложения, это отдельная ситуация. В таком случае нужно проверить очередь запросов, состояние приложения и настройки самого бизнес-процесса.
Как настроить бизнес-процесс, чтобы обработать превышение лимита
Рекомендуем учитывать возможный ответ о превышении лимита в логике бизнес-процесса. Для этого можно проверять результат выполнения действия REST-Активити и настраивать отдельную ветку обработки ошибки.
Например, при получении ответа о превышении лимита бизнес-процесс может:
- уведомить ответственного сотрудника;
- записать понятный комментарий в элемент CRM или задачу;
- остановить выполнение с пояснением причины;
- передать элемент на ручную проверку;
- запустить повторную обработку после устранения причины, если такая логика предусмотрена в вашем процессе.