SPREEAI/Mga Developer/Mga Dokumento

Pagbuti ng
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.

Mga Guides ng PublicMga Silikon ng Web SDK v2.1Updated sa Agosto 2026

I-select ang integration path

Mga PahayagBest para saAng unang aksyon
Mga App sa ShopifyMga Pag-iisip sa StoragefrontI-install ang app
Mga Web SDKAng mga web na walang headlineTingnan ang mga SDK Guide
Mga pangunahing / AndroidMga Mga Mga Mga Pag-atake AppsMga Tulong sa Native Guide
Mga Pampublikong APIMga Serveh-side Workflows sa pamamagitan ng ServehAng Open Approval
Mga Partner ng Amazon NetworkAng market integrationMalapit na
Mga seguridad ng creditorya. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Mga App sa 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. Ipinagdag ng Official SPREEAI app at mag-aaral ang mga managdag ng pag-aalis ng consent flow.
  2. Sinusuri ang isang unang catalog group at review na produkto pag-aari ng mga estado.
  3. Customize ang layout at styling sa isang duplicated theme.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Ang pag-aaral ay hindi lamang pagkatapos ng brand at QA na pagsasanay.

Ipinagdag ng Official Shopify onboarding guide

Mabilisang Gabay sa Web SDK

Mga Ulang @ spreeai Mga Web-Sdk para sa custom placement, styling, mga event, size at cartridge behavior.

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 Mga Pag-aaral ng Web SDK API

Mga 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.

Ipinagdag ng isang mag-apokalan ng Public API Reference

Mga Baseline ng Asset

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Isang dress per image, nakikipag-centrated sa mga clean edges at neutral, kahit na lumabas.
  • Ang pag-ibig ay kailangan; back view ay magsagawa kapag ito experience ay may-aktive.
  • 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 maping checked sa loob ng experience.

QA at ang mga start

  • Testihin ang buong customer journey sa mga mobile at desktop browsers.
  • Verify ang produkto at variation maping, pag-aari ng dressing at karagdagang behavior.
  • Check keyboard access, focus order, mga accessed na pangalan at fallback na pagbabago.
  • Mga pag-aaral ng produkto sa pag-ibig para sa at pagkatapos ng pag-ibig SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Ang pag-aari ng mga konsensus na language at mag-approved handling ng customer image.
  • Dapat ang engineering, commerce, QA at brand sign-off bago ang produksyon.

Mga problema

Ang button ay hindi nag-atake

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.

Ang malapit na produkto o variante ay kinakailangan

I-comparate ang storefront na produkto at variante ID sa mga record na nakuha sa SPREEAI. Ang pag-aalis na pagbabago ng mga request ay may mababang kapag ang nabasa ay mag-aalis sa mga variante.

Ang experience ay slow o hindi na dapat mag-aktualized

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.

Mga Support ng Developer

Email sa support@spreeai.com sa pamamagitan ng mga produkto o dress ID, browser o vic e, ang mga oras na nabasa, ang mga pag-aaral at ang mga pagiging reproduction. Huwag mag-inklud ng mga salita o mga larawan ng customer.

Ikaw ay magsisimula ang iyong language.