Guia de migração | SDK 2.0

De Web SDK v2

Mudança	Ação
partnerId removido do início	Passe apenas clientId. Resolva a configuração do parceiro por meio de autenticação.
features.loadingScreen removido	Remova as opções personalizadas da tela de carregamento e o tipo removido.
A origem hospedada padrão agora é vton.spreeai.com	Revise as substituições baseURL explícitas e as regras de frame-src do CSP com seu ambiente aprovado.
Layout da caixa de diálogo alterado	Verifique novamente o CSS da caixa de diálogo personalizada, o comportamento de tela cheia do celular e o manuseio de rolagem/foco.

Inicialização atual

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

Do legado v1

Substitua o único tryOnButton() ligue com um init() ligue e um ou mais sdk.renderTryOnButton() chamadas. Substitua a antiga entrada de peça única por garments. Atualizar o manuseio do carrinho para um garments matriz em vez de uma única peça de roupa.

Lista de verificação de migração

Registre o pacote instalado, a compilação hospedada em funcionamento conhecida e a configuração aprovada.
Fixe v3.0.0 e compile a integração atualizada no teste.
Verifique a autenticação, peça única, correspondência de variante e substituto de roupa.
Exibição de tamanho de teste, recomendações de tamanho e manuseio do carrinho somente quando suportado.
Corre a lista de verificação de produção no desktop e no celular.
Promova através do processo aprovado. Mantenha um pacote de trabalho conhecido e uma configuração disponível para reversão.

Reverter

Se a autenticação, a elegibilidade do produto ou o comportamento de compra regredirem, interrompa a implementação e restaure o último pacote e configuração compatíveis verificados. Preservar etapas de reprodução e IDs de correlação. Confirme a experiência restaurada em vez de depender apenas de uma implantação bem-sucedida.

Referências de origem