ERROR_OAUTH: Application not installed | Битрикс записи

Задача

Разобрать поведение локального или OAuth-приложения, placement, слайдер или установку.

Задача — eRROR_OAUTH: Application not installed. Установка, client id, portal, callbacks.

Главное — не искать один универсальный метод, а сначала определить сущность, права и слой API, через который выполняется действие.

Как это устроено

Приложение работает внутри контекста портала: место встройки передаёт параметры, OAuth ограничивает права scope, а iframe накладывает ограничения браузера и безопасности.

OAuth-приложение живёт на паре access token и refresh token. Если токены не сохранены или приложение переустановили, старые запросы будут выглядеть как будто приложение не установлено.

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

Рабочий подход

Проверяйте установку приложения, handler URL, права, scopes и фактический результат BX24.placement.info. Для карточек CRM не просите пользователя вводить ID вручную — берите его из контекста размещения.

Сделайте минимальный тест на одной сущности, сохраните входные данные и ответ метода, а затем расширяйте решение на массовый сценарий.

На коробке удобнее добавлять временное логирование рядом с местом выполнения кода, а в облаке — сохранять входящие и исходящие REST-запросы в свой журнал интеграции.

Частые ошибки

Если после placement.bind открывается install.php, часто проблема не в самом placement, а в URL обработчика, незавершённой установке или старой записи размещения.

Проверять сценарий только под администратором и не видеть проблему прав обычного пользователя.
Смешивать ID разных сущностей: задачу, файл Диска, CRM-дело, товарную строку или пользователя.
Не логировать фактический запрос и ответ, из-за чего ошибка выглядит случайной.