SPREEAI/Udviklere/Dokumentation

Byg 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 guideWeb SDK v2.1Opdateret i august 2026

Vælg integrationsvej

VejenBedst forFørste handling
Shopify-appHurtig håndtering af storefrontInstallation af app
Web-SDKWeb eller web uden overskriftLæs SDK guide
iOS / AndroidNative shopping appsVælg en indfødt guide
Offentlige API'erGodkendte server-side arbejdstrømmeÅben godkendt reference
Amazon Partner NetværkMarkedsintegrationKommer snart
Den pågældende sikkerhed. 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. Installation af officielle SPREEAI app og afslutte den administrerede samtykkestrøm.
  2. Synkroniser en oprindelig kataloggruppe og gennemgå produktberedskabsstatus.
  3. Tilpasning og styling i et duplikeret tema.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Udgives kun efter brand og QA godkendelse.

Åbning af den officielle Shopify onboarding guide

Web SDK-hurtigstart

Brug af @ spreeai Web-sdk til personlig placering, styling, begivenheder, størrelsesmæssige og kartfærd.

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 Officiel web SDK API reference

Brandsøgning adgang

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.

Åbne den godkendte offentlige API-reference

Bagage for aktiver 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.
  • Frontview er nødvendig; Backview anbefales, når denne oplevelse er aktiveret.
  • 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 kontrolleres, før den oplevelse er muliggørende.

QA og lancering

  • Test hele kundesiden på nuværende mobile og desktop browsere.
  • Verify product and variant mapping, garment readiness and cart behavior.
  • Kontroller tastaturadgang, fokusordre, tilgængelige navne og fallback adfærd.
  • Måling af produkt-side præstation før og efter aktivering SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Bekræft samtykkesprog og godkendt håndtering af kundebilleder.
  • Få ingeniør, handel, QA og brand sign-off før produktion.

Fejlfinding

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

Den forkerte produkt eller variant vises

Sammenlign produkt og variation ID'er med de poster, der sendes til SPREEAI. Bekræft, at den tilbagevendte anmodning ændres, når køberen ændrer varianter.

Erfaringen er langsom eller utilgængelig

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

E-mail support@spreeai.com med miljøet, produkt eller tøj ID, browser eller vic e, den nærmeste tidsramme, forventede adfærd og reproduktionsstager. Ikke inkludere hemmeligheder eller kundebilleder.

Vælg dit sprog.