Guía de migración

Desde Web SDK v2

Cambio	acción
partnerId eliminado del inicio	Pase solo clientId. Resolver la configuración del socio mediante autenticación.
features.loadingScreen eliminado	Elimine las opciones personalizadas de la pantalla de carga y el tipo eliminado.
El origen alojado predeterminado ahora es vton.spreeai.com	Revise las anulaciones explícitas de baseURL y las reglas frame-src de CSP con su entorno aprobado.
Diseño de diálogo cambiado	Vuelva a verificar el CSS del cuadro de diálogo personalizado, el comportamiento de pantalla completa del dispositivo móvil y el manejo de desplazamiento/enfoque.

Inicialización actual

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" } },
  });
}

Del legado v1

Reemplace el sencillo tryOnButton() llama con uno init() llamar y uno o más sdk.renderTryOnButton() llamadas. Reemplace la antigua entrada de prenda única con garments. Actualizar el manejo del carrito para un garments conjunto en lugar de una sola prenda.

Lista de verificación de migración

Registre el paquete instalado, la compilación alojada que funcione y la configuración aprobada.
Fije v3.0.0 y compile la integración actualizada en la etapa de preparación.
Verifique la autenticación, la prenda única, la combinación de variantes y la reserva de vestimenta.
Pruebe la visualización del tamaño, las recomendaciones de tamaño y el manejo del carrito solo cuando sea posible.
correr la lista de verificación de producción en computadoras de escritorio y dispositivos móviles.
Promocionar a través del proceso aprobado. Mantenga un paquete de trabajo conocido y una configuración disponibles para revertir.

Revertir

Si la autenticación, la elegibilidad del producto o el comportamiento de compra retroceden, detenga la implementación y restaure el último paquete y configuración compatibles verificados. Conserve los pasos de reproducción y los ID de correlación. Confirme la experiencia restaurada en lugar de depender únicamente de una implementación exitosa.

Referencias fuente