Local vs Marketplace приложение: выбор

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

Что такое local и marketplace приложение

Локальное приложение регистрируется на конкретном портале в разделе «Разработчикам → Другое → Локальное приложение» и доступно только внутри этого аккаунта Битрикс24. Оно получает собственные client_id и client_secret, привязанные к порталу.

Тиражное (marketplace) приложение создаётся в личном кабинете партнёра на partners.bitrix24.ru, проходит модерацию и публикуется в каталоге Маркета. Его может установить любой портал, а авторизация идёт через единый OAuth-сервер oauth.bitrix.info.

Сравнение по ключевым параметрам

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

Локальное решение выигрывает по скорости старта, тиражное — по охвату и возможности продавать.

Различия в авторизации

Это главное техническое отличие. У локального приложения client_id выдаёт сам портал, и запрос токена уходит на его домен. У тиражного приложения авторизация всегда проходит через централизованный сервер Битрикс.

• Локальное: обмен кода на токен идёт на https://portal.bitrix24.ru/oauth/token/;
• Тиражное: обмен идёт на https://oauth.bitrix.info/oauth/token/, туда же уходит запрос обновления refresh_token.

Когда выбирать локальное приложение

Локальный формат оптимален, когда решение делается под конкретного заказчика и не предназначено для продажи.

• Внутренняя автоматизация одного портала: роботы, кастомные встройки, интеграция с 1С или сайтом;
• Прототип или MVP, который позже можно переоформить в тиражное;
• Проекты с чувствительной логикой, которую нельзя раскрывать в публичном каталоге;
• Быстрые доработки, где не нужна модерация и версионирование.

Локальные приложения бывают трёх подтипов: серверные (без интерфейса, только REST-события), с пользовательским интерфейсом (указывается путь к обработчику) и только с вебхуком. Первый выбор влияет на то, будет ли у приложения iframe и placement.

Когда выбирать тиражное приложение

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

• Продуктовая идея для широкого рынка: телефония, аналитика, коннекторы к внешним сервисам;
• Модель монетизации через подписку или единоразовую покупку;
• Нужна витрина, отзывы и органический трафик из каталога Маркета.

Переход от локального к тиражному

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

1. Заменить логику авторизации на работу через единый OAuth-сервер и динамический домен;
2. Убрать привязки к конкретным ID полей, стадий и пользователей;
3. Реализовать инсталлятор: страницу установки и обработку ONAPPINSTALL с регистрацией placement и роботов;
4. Добавить страницу настроек и корректную деинсталляцию;
5. Подготовить карточку, описание и требуемые scope для модерации.

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

Чек-лист выбора типа

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

1. Сколько порталов будет использовать решение? Один — локальное, много — тиражное;
2. Нужна ли монетизация через платформу? Да — только тиражное с биллингом Маркета;
3. Готовы ли к модерации и версионированию? Нет и решение внутреннее — локальное;
4. Есть ли зависимость от конкретных ID и настроек портала? Если да, для тиража эту зависимость придётся устранить;
5. Насколько чувствительна логика? Публичный каталог раскрывает факт существования приложения, но не исходный код обработчиков.

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

Итог

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

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