SPREEAI/Utviklere/Dokumentasjon

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

Offentlig guideNettsted SDK v2.1Oppdatert august 2026

Velg integrasjonsveien

VeienBest forFørste handling
Shopify-appRask håndtering av storefrontInstallere appen
Web-SDKPersonlig eller uten overskriftLes SDK-guiden
iOS / AndroidNative shopping appsVelg en innfødt guide
Offentlige API-erGodkjente server-side arbeidsflyterÅpne godkjente referanser
Amazon Partner nettverkMarkedsintegrasjonKommer snart
Kreditt sikkerhet. 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. Installere offisielle SPREEAI app og fullføre den administrerte samtykkestrømmen.
  2. Synkronisere en opprinnelig kataloggruppe og gjennomgå produktberedskapstilstander.
  3. Tilpass plassering og styling i et duplikert tema.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Publisere bare etter varemerke og QA godkjennelse.

Åpne den offisielle Shopify-bordsguiden

Hurtigstart for Web SDK

Bruker @ spreeai Nettsted - Sdk for tilpasset plassering, styling, arrangementer, størrelser og kjøretilførsel.

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 Offisiell web SDK API referanse

Branntilgang

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.

Åpne den godkjente offentlige API-referansen

Garment asset baseline

  • 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.
  • Frontvisning kreves; backvisning anbefales når denne opplevelsen er aktivert.
  • 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 sjekket før muliggjøring av opplevelsen.

QA og lansering

  • Test hele kundesiden på nåværende mobile og skrivebordsbrowsere.
  • Verify product and variant mapping, garment readiness and cart behavior.
  • Sjekk tastaturtilgang, fokusordre, tilgjengelige navn og fallback oppførsel.
  • Måler produkt-siden ytelse før og etter muliggjøring SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Bekreft samtykke språk og godkjent håndtering av kundebildet.
  • Få ingeniør, handel, QA og merke sign-off før produksjon.

Feilsøking

Buttoken vises ikke

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.

Det feil produktet eller varianten vises

Sammenlign storefront-produktet og varianten ID-er med de oppførte opplysningene som sendes til SPREEAI. Bekreft at den tilbakebetalte forespørselen endres når kjøperen endrer varianter.

Opplevelsen er langsom eller utilgjengelig

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å utviklerens støtte

E-post support@spreeai.com med miljøet, produkt eller klær ID, nettleser eller vic e, nært tidstamp, forventet atferd og reproduksjonssteg. Ikke inkludere hemmeligheter eller kundebilder.

Velg ditt språk.