SPREEAI/pengembang/Dokumentasi

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.

Panduan PublikWeb SDK v2.1Dikemaskini Agustus 2026

Pilih jalur integrasi

Jalanyang terbaik untukTindakan Pertama
Aplikasi ShopifyPengaturan Storefront yang cepatInstalasi Aplikasi
SDK WebWeb yang tidak berjudul atau tanpa headBaca Panduan SDK
Android / AndroidAplikasi belanja asliPilih Panduan Penduduk
API publikSertifikasi Sertifikasi Server-Side WorkflowsReferensi Terbuka yang Disetujui
Jaringan Mitra AmazonIntegrasi pasarAkan segera datang
keamanan yang aman. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

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.

  1. Instalasi Pegawai SPREEAI Aplikasi dan menyelesaikan aliran persetujuan yang diurus.
  2. Sinkronisasi kelompok katalog awal dan ulasan status kesiapan produk.
  3. Customize penempatan dan styling dalam tema duplikat.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Hanya setelah brand dan QA yang disetujui.

Buka Panduan Official Shopify Onboarding

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.

Membuka referensi API publik yang disetujui

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.

Pilih bahasa Anda.