Программный доступ: API Витрины QR

Токен доступа — не то же самое, что вход в кабинет. Сессия браузера живёт в устройстве и гаснет при смене пароля; токен нужен программе на сервере и обязан это переживать. Поэтому он выпускается отдельно и отзывается отдельно.

При выпуске токен показывается ровно один раз. В базе остаётся только его отпечаток, поэтому «напомнить» токен сервис не может физически — утраченный отзывают и выпускают новый. Это то же правило, что и у кодов управления страницами.

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

Витрина — самый тяжёлый объект сервиса: логотип и обложка хранятся строками data:, а товаров бывает сотня. Поэтому список витрин отдаёт только карточки — название, число товаров, открытия и заказы. Полный состав приходит по адресу конкретной витрины, и запрос за списком не превращается в мегабайты трафика.

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

Правка витрины устроена как правка страницы: PATCH с одним полем меняет только его. Скрипт, обновляющий цены по выгрузке, не сотрёт контакты и описание. Каждая программная правка попадает в ту же историю версий, что и правка руками, — то есть откатывается из управления витриной.

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

Это не пробел, который когда-нибудь заполнится «расширенной аналитикой». Обещание «считаем переходы, не людей» закреплено тестами сервиса, и программный доступ его не обходит: отдать через API то, чего не собираешь, невозможно.

Начните с одной учебной выгрузки и одного результата: создать короткую ссылку, получить QR в SVG или опубликовать небольшой каталог. Не переносите весь ассортимент и не меняйте рабочую учётную систему до того, как этот путь воспроизводимо пройдёт на тестовых данных.

Для совместного пилота пришлите описание своей аудитории или интеграции, адрес будущего материала и критерий результата. Секретный токен, реальные заказы и клиентскую базу присылать нельзя.