Ab Web SDK v2
| Veränderung | Aktion |
|---|---|
| partnerId aus Init entfernt | Nur clientId übergeben. Lösen Sie die Partnerkonfiguration durch Authentifizierung auf. |
| features.loadingScreen entfernt | Entfernen Sie benutzerdefinierte Ladebildschirmoptionen und den entfernten Typ. |
| Der standardmäßig gehostete Ursprung ist jetzt vton.spreeai.com | Überprüfen Sie explizite baseURL-Überschreibungen und CSP-Frame-SRC-Regeln mit Ihrer genehmigten Umgebung. |
| Dialoglayout geändert | Überprüfen Sie das CSS des benutzerdefinierten Dialogs, das mobile Vollbildverhalten und die Scroll-/Fokus-Handhabung erneut. |
Aktuelle Initialisierung
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" } },
});
}Von Legacy v1
Ersetzen Sie die Single tryOnButton() mit einem anrufen init() Anruf und ein oder mehrere sdk.renderTryOnButton() Anrufe. Ersetzen Sie die alte Einzelkleidungseingabe durch garments. Aktualisieren Sie die Warenkorbabwicklung für a garments Array statt eines einzelnen Kleidungsstücks.
Checkliste für die Migration
- Notieren Sie das installierte Paket, den bekanntermaßen funktionierenden gehosteten Build und die genehmigte Konfiguration.
- Pin v3.0.0 und kompilieren Sie die aktualisierte Integration im Staging.
- Überprüfen Sie Authentifizierung, einzelnes Kleidungsstück, Variantenabgleich und Outfit-Fallback.
- Anzeige der Testgröße, Größenempfehlungen und Handhabung des Einkaufswagens nur, sofern dies unterstützt wird.
- Lauf die Produktionscheckliste auf Desktop und Mobilgeräten.
- Bewerben Sie durch den genehmigten Prozess. Halten Sie ein bekanntes Arbeitspaket und eine bekannte Konfiguration für ein Rollback bereit.
Rollback
Wenn Authentifizierung, Produktberechtigung oder Kaufverhalten zurückgehen, stoppen Sie den Rollout und stellen Sie das zuletzt überprüfte kompatible Paket und die letzte Konfiguration wieder her. Behalten Sie Reproduktionsschritte und Korrelations-IDs bei. Bestätigen Sie das wiederhergestellte Erlebnis, anstatt sich nur auf eine erfolgreiche Bereitstellung zu verlassen.