Интеграция Verstka в сайт

Verstka подключается к CMS как визуальный редактор интерактивных публикаций. Сайт отвечает за хранение и публикацию материала; Verstka возвращает HTML, состояние редактора и медиа.

Что происходит технически

1. Backend сайта передаёт material_id, callback_url и сохранённый vms_json в API Verstka и получает URL редактора.
2. CMS открывает редактор в новой вкладке.
3. После сохранения Verstka отправляет callback на сайт со ссылкой на ZIP публикации.
4. Сайт проверяет подпись, скачивает ZIP, сохраняет медиа и заменяет временные URL публичными в HTML и JSON.
5. Сайт сохраняет vms_html и обновлённый vms_json, возвращает JSON в ответе callback и выводит HTML на публичной странице с viewer runtime.

SDK подписывает запросы, проверяет callback, скачивает ZIP, заменяет URL файлов и формирует ответ Verstka. Сохранение файлов выполняется через storage adapter сайта.

Что нужно реализовать на сайте

• Route в админке, который проверяет права и открывает редактор через SDK или API.
• Callback route для сохранения публикаций и обновления шрифтов сайта.
• Публичное хранилище медиа и шрифтов.
• Хранение HTML и состояния редактора в CMS.
• Вывод сохранённого HTML и инициализацию viewer на странице публикации.

Что хранит сайт

Поле	Назначение
vms_html	HTML для публичной страницы.
vms_json	Состояние для повторного открытия редактора.
is_verstka	Признак публикации Verstka в CMS.

Для vms_html и vms_json нужны поля большого объёма: например, TEXT/JSONB в PostgreSQL или LONGTEXT/JSON в MySQL.

Дальше

• Порядок интеграции — backend routes, хранение файлов и callback.
• API без SDK — endpoints, подписи и payload.
• Интеграция на клиентском сайте — viewer и публикация HTML.
• Клиентская аналитика — провайдеры и события.