← Назад к заметкам

Заметки

Кодировка/base64 при загрузке модуля в маркетплейс

Кодировка/base64 при загрузке модуля в маркетплейс: Архив, структура, файлы, проверка.

Кодировка/base64 при загрузке модуля в маркетплейс. Основной фокус: Архив, структура, файлы, проверка.

Задача

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

Задача — кодировка/base64 при загрузке модуля в маркетплейс. Архив, структура, файлы, проверка.

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

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

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

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

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

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

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

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

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

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

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

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