Руководство по миграции

Из Web SDK v2

Изменения	Действие
partnerId удален из инициализации.	Передайте только clientId. Разрешите настройку партнера посредством аутентификации.
features.loadingScreen удален.	Удалите пользовательские параметры экрана загрузки и удаленный тип.
Размещенный источник по умолчанию теперь vton.spreeai.com.	Ознакомьтесь с явными переопределениями baseURL и правилами источника кадров CSP в утвержденной среде.
Расположение диалога изменено	Перепроверьте CSS пользовательского диалогового окна, поведение мобильного полноэкранного режима и обработку прокрутки/фокуса.

Текущая инициализация

TypeScript

import { init } from "@spreeai/web-sdk";
const sdk = await init({ clientId: "YOUR_ISSUED_CLIENT_ID" });
if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "YOUR_READY_GARMENT_ID" }],
    features: { tryOnButton: { text: "Try it on you" } },
  });
}

Из наследия v1

Заменить сингл tryOnButton() позвонить с одним init() позвонить и один или несколько sdk.renderTryOnButton() звонки. Замените старый ввод одного предмета одежды на garments. Обновить обработку корзины для garments массив, а не один предмет одежды.

Контрольный список миграции

Запишите установленный пакет, известную рабочую размещенную сборку и утвержденную конфигурацию.
Закрепите v3.0.0 и скомпилируйте обновленную интеграцию в промежуточной версии.
Проверьте аутентификацию, один предмет одежды, сопоставление вариантов и резервный вариант наряда.
Отображение тестовых размеров, рекомендации по размерам и управление корзиной только там, где это поддерживается.
Беги производственный контрольный список на настольных и мобильных устройствах.
Продвижение через утвержденный процесс. Сохраняйте известный рабочий пакет и конфигурацию доступными для отката.

Откат

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

Ссылки на источники