Приложения и интеграции

Application — это витрина проекта: сайт, мобильное приложение, miniapp или сервис. Через него проходит всё, что видит клиент, и именно к нему привязаны токен, склады, ассортимент и уведомления. Раздел собирает настройку приложения и служебные методы, которыми пользуются все остальные разделы.

Страницы раздела

Задача	Страница
Приложение, App Token, склады и ассортимент витрины, вебхуки	приложения и webhooks
Загрузка картинок и документов для контента и каталога	файлы и медиа
Расчёт цены и подсказки адресов	калькулятор и подсказки

Что решает приложение

 Application ──> App Token ──> витрина читает каталог и контент
      │
      ├── склады: с каких остатков продаём
      ├── категории и бренды: какие фильтры видит клиент
      ├── подписочные тарифы: что показывать в каталоге подписок
      └── вебхуки: чем ваш backend узнаёт об оплате

Один проект может держать несколько приложений — сайт, miniapp, мобильное — и каждому дать свой набор складов, категорий и тарифов. Поэтому «пустой каталог» почти всегда решается не на стороне товара, а здесь: правила выдачи и сборка витрины.

Вебхуки

Приложению доступно единственное событие — order.paid. Событий об изменении контента, остатков или подписок нет: если кэшируете данные у себя, сбрасывайте кэш сами. Подпись, повторы и разбор доставок — на странице вебхуков.

Границы проекта

Само приложение закрыто политикой: чужое недоступно ни на чтение, ни на изменение. А вот вложенные ресурсы — категории, бренды, пункты меню, порядок складов — находятся по переданному id без проверки проекта. В скриптах синхронизации сверяйте id на своей стороне.

Дальше

Собрать витрину магазина — управление магазином из кода.
Наполнить контент — headless-управление.
Назначить тарифы — управление подписками.