SPREEAI/Ontwikkelaars/Documentatie

Gebouwd met
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 GuideWeb SDK v2.1Updated augustus 2026

Kies de integratiepad

PathBeste voorEerste actie
Shopify-appSnelle beheerde storefront setupInstalleren van de app
Web-sdkWeb of hoofdloze webLees de SDK-gids
iOS / AndroidNative Shopping appsKies een native guide
Openbare API'sGecertificeerde server-side werkstromenOpen goedgekeurde referentie
Amazon PartnernetwerkMarketplace integratieBinnenkort beschikbaar
Vertrouwensveiligheid. 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. Installeer de officiële SPREEAI App en voltooien de beheerde toestemmingstromen.
  2. Synchroniseren van een oorspronkelijke catalogue groep en beoordelen van de product bereidheid staten.
  3. Styling en placement aanpassen in een duplicate thema.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Alleen na brand en QA goedkeuring.

Open de officiële Shopify onboarding gids

Web SDK-snelstartgids

Gebruik @ spreeai /websdk voor aangepaste plaatsing, styling, evenementen, grootte en cartoons gedrag.

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 Officiële web SDK API referentie

API toegang

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.

Open de goedgekeurde openbare API-referentie

Garment asset baseline

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Eén kleding per afbeelding, geconcentreerd met schone rand en neutraal, zelfs verlichting.
  • Voordat u de voorbeeld wilt zien; terugkijk wordt aanbevolen wanneer deze ervaring is ingeschakeld.
  • 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 gecontroleerd voordat de ervaring mogelijk wordt.

QA en lancering

  • Test de volledige klantreis op de huidige mobiele en desktopbrowsers.
  • Controleer product en variëteit mappen, kledingbereidheid en kist gedrag.
  • Check keyboard-toegang, focusordre, toegankelijke namen en fallback gedrag.
  • De prestaties van product-pagina voor en na het mogelijk maken SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Bevestig de taal van toestemming en goedgekeurde verwerking van klantbeeld.
  • Krijg engineering, handel, QA en merk sign-off voor de productie.

Probleemoplossing

De knop verschijnt niet

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.

Het verkeerde product of variant verschijnt

Vergelijk het product en varianten-ID's met de opgenomen records SPREEAI. Bevestig dat de ingediende verzoek verandert wanneer de koper varianten wijzigt.

De ervaring is langzaam of niet beschikbaar

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.

Ontwikkelaar ondersteuning

E-mail support@spreeai.com met de omgeving, product of kleding ID, browser of vic e, de aanzienlijke tijdstamp, verwachte gedrag en reproductietap. Vergeet geen geheimen of klantbeeldingen.

Kies je taal.