Bangun dengan
SPREEAI.
A practical path from integration choice to a tested launch. Start with one commerce journey, use issued test access and keep credentials out of browser code.
Pilih jalur integrasi
Aplikasi Shopify
Use the managed app when the store runs on Shopify and does not need a custom backend. The current onboarding flow connects the store after agreements and subscription; it does not require copying API keys into the setup screen.
- Instalasi Pegawai SPREEAI Aplikasi dan menyelesaikan aliran persetujuan yang diurus.
- Sinkronisasi kelompok katalog awal dan ulasan status kesiapan produk.
- Customize penempatan dan styling dalam tema duplikat.
- Validate eligible products, variants, mobile behavior and add-to-cart.
- Hanya setelah brand dan QA yang disetujui.
Web SDK dengan cepat
Penggunaan @ spreeai Web-Sdk yang Untuk penempatan tersuai, styling, acara, ukuran dan perilaku keranjang.
npm install @spreeai/web-sdk
import { init } from "@spreeai/web-sdk";
const sdk = await init({
clientId: "your-client-id",
partnerId: "your-partner-id"
});
sdk.renderTryOnButton({
selector: "#spreeai-try-on",
productId: product.id,
enableAddToCart: true
});
Initialize once, render only for an eligible product and connect documented client callbacks to your existing analytics. Confirm the current interface in the Web SDK API Referensi
Akses API
Use the public Swagger reference only for server-side workflows approved during onboarding. Keep secrets on your server, separate test and production access, and scope credentials to the minimum required environment.
Direct REST endpoints, webhooks or authentication behaviors not present in the approved public reference should be treated as unavailable until Partner Engineering confirms them.
Aset Baseline
- JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
- Satu pakaian per gambar, berpusat dengan tepi bersih dan neutral, bahkan pencahayaan.
- View depan diperlukan; back view disarankan ketika pengalaman tersebut diaktifkan.
- Stable SKU, style or garment ID included in the filename and catalogue record.
- No hands, hangers, styling props, watermarks or unrelated garments blocking the item.
- Variant mapping diperiksa sebelum memungkinkan pengalaman.
QA dan peluncuran
- Uji perjalanan pelanggan lengkap pada browser mobile dan desktop saat ini.
- Periksa produk dan varian pemetaan, kesiapan pakaian dan perilaku keranjang.
- Periksa akses keyboard, fokus perintah, nama yang dapat diakses dan perilaku jatuh.
- Mengukur kinerja produk-halaman sebelum dan setelah memungkinkan SPREEAI.
- Exercise loading, empty, unavailable, timeout and retry states.
- Mengkonfirmasi bahasa persetujuan dan pengendalian yang disetujui dari gambar pelanggan.
- Dapatkan teknik, perdagangan, QA dan tanda tangan merek sebelum produksi.
Penyelesaian masalah
Butang tidak muncul
Confirm SDK initialization, client and partner identifiers, the target selector, product eligibility, garment readiness and variant mapping. Then check browser console and network errors without sharing tokens.
Produk atau varian yang salah muncul
Bandingkan produk storefront dan varian ID dengan rekaman yang dikirim ke SPREEAI. Periksa bahwa permintaan yang diusulkan berubah ketika pembeli mengubah varian.
Pengalaman yang lambat atau tidak tersedia
Test a known-ready product, verify the active environment, inspect blocked requests and compare a clean browser session. Capture a timestamp and reproducible sequence for support.
Dapatkan dukungan pengembang
Email support@spreeai.com dengan lingkungan, produk atau pakaian ID, browser atau vic e, jangka waktu yang mendekati, perilaku yang diharapkan dan langkah reproduksi. Jangan mencakup rahasia atau gambar pelanggan.