Guide de migration | SDK 2.0

À partir de Web SDK v2

Changement	Action
partnerId supprimé de l'initialisation	Passez uniquement le clientId. Résolvez la configuration du partenaire via l’authentification.
features.loadingScreen supprimé	Supprimez les options d'écran de chargement personnalisées et le type supprimé.
L'origine hébergée par défaut est désormais vton.spreeai.com	Examinez les remplacements explicites de baseURL et les règles frame-src CSP avec votre environnement approuvé.
La disposition de la boîte de dialogue a été modifiée	Revérifiez le CSS de la boîte de dialogue personnalisée, le comportement mobile en plein écran et la gestion du défilement/mise au point.

Initialisation actuelle

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

De l'ancienne v1

Remplacer le single tryOnButton() appeler avec un init() appel et un ou plusieurs sdk.renderTryOnButton() appels. Remplacez l'ancienne entrée de vêtement unique par garments. Mettre à jour la gestion du panier pour un garments ensemble plutôt qu’un seul vêtement.

Liste de contrôle pour la migration

Enregistrez le package installé, la version hébergée fonctionnelle connue et la configuration approuvée.
Épinglez la v3.0.0 et compilez l’intégration mise à jour dans la préparation.
Vérifiez l'authentification, le vêtement unique, la correspondance des variantes et la tenue de secours.
Testez l’affichage de la taille, les recommandations de dimensionnement et la manipulation du chariot uniquement lorsque cela est pris en charge.
Courir la liste de contrôle de production sur ordinateur et mobile.
Promouvoir à travers le processus approuvé. Conservez un package de travail et une configuration connus disponibles pour la restauration.

Restauration

Si l’authentification, l’éligibilité du produit ou le comportement d’achat régressent, arrêtez le déploiement et restaurez le dernier package et configuration compatible vérifié. Conservez les étapes de reproduction et les ID de corrélation. Confirmez l’expérience restaurée plutôt que de compter uniquement sur un déploiement réussi.

Références sources