SPREEAI/Utvecklare/Dokumentation

Bygg med
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.

Public guideWebb SDK v2.1Uppdaterad augusti 2026

Välj integrationsvägen

VägenBästa förFörsta åtgärden
Shopify-appSnabbhanterad StorefrontInstallera app
Webb-SDKAnpassad eller headless webLäs SDK guide
iOS / AndroidNative shopping appsVälj en inhemska guide
Public APIsGodkända server-sidor arbetsflödenÖppen godkända referens
Amazon Partner NetworkmarknadsintegrationKommer snart
tillförlitlig säkerhet. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Shopify-app

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. Installera den officiella SPREEAI app och slutföra den hanterade samtyckeflödet.
  2. Synkronisera en ursprunglig kataloggrupp och granska produktberedskapsstater.
  3. Anpassa placering och styling i ett dubbel tema.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Publicera endast efter varumärkes- och QA-godkännande.

Öppna den officiella Shopify-bordsguiden

Webb SDK snabbstart

Användning @ spreeai Webbplatser Sdk för anpassad placering, styling, evenemang, storlek och vagn beteende.

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 Officiell web SDK API referens

API tillträde

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.

Öppna den godkända offentliga API-referensen

Klädselbaserad tillgång

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • One garment per image, centered with clean edges and neutral, even lighting.
  • Frontvisa krävs; backvisa rekommenderas när den upplevelsen är aktiverad.
  • 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 mappning kontrolleras innan du möjliggör upplevelsen.

QA och lansering

  • Testa hela kundresan på nuvarande mobila och skrivbordssökare.
  • Verify product and variant mapping, garment readiness and cart behavior.
  • Kontrollera tangentbordstillgång, fokusorder, tillgängliga namn och fallback beteende.
  • Mät produktsida prestanda före och efter möjliggörande SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Bekräfta samtycke språk och godkända hantering av kundbild.
  • Få teknik, handel, QA och varumärkes sign-off innan produktion.

Problemlösning

knappen visas inte

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.

fel produkt eller variant visas

Jämför produkt och variabel-ID med de poster som skickas till SPREEAI. Bekräfta att den utfärdade begäran ändras när köparen ändrar varianter.

Erfarenheten är långsam eller otillgänglig

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.

Få utvecklingsstöd

E-post support@spreeai.com med miljön, produkt eller klädnummer, webbläsare eller vic e, ungefärlig tidsbegränsning, förväntade beteenden och reproduktionssteg. Inkludera inte hemligheter eller kundbilder.

Välj ditt språk.