SPREEAI/Kehittäjät/Dokumentti

Rakennetaan yhdessä
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.

Julkinen opasWeb SDK v2.1 -ohjelmaPäivitetään elokuussa 2026

Valitse integraatioradion

MatkallaParasta onEnsimmäinen toiminta
Shopify-sovellusNopea hallinta Storefront -asetuksetAsenna app
Verkko-SDKWEB tai WEB ilman päätäLue SDK:n opas
iOS / AndroidKotimainen ostosappiValitse alkuperäinen opas
Julkinen APIsHyväksyttyjen palvelinpuolisten työnkulkujenAvoin hyväksytty viittaus
Amazonin kumppaniverkostoMarkkinoiden yhdentyminenTulee pian
Luottamus turvallisuus. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Shopify-sovellus

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. Aseta virkamies SPREEAI sovelletaan ja täydennetään hallittu suostumuksen virta.
  2. Synkronoi alkuperäisen luetteloryhmän ja tarkistaa tuotteen valmius-tilat.
  3. Aseta ja tyyliä kaksinkertaiseen teemaan.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Julkaistaan vain brändin ja QA:n hyväksynnän jälkeen.

Avaa Shopifyn virallinen navigointiopas

SDK -sivuston nopean käynnistyksen

Käytä @ spreeai /WEB Sdk mukautetun asennuksen, tyylin, tapahtumien, kokoonpanon ja autojen käyttäytymisen osalta.

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 Virallinen Web SDK API viittaus

Ilman pääsyä

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.

Avaa hyväksytty julkinen API-viittaus

Huonekalut perusta

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Yksi vaatteet kuvaa kohden, keskittynyt puhtailla reunuksilla ja neutraalilla, jopa valaistuksella.
  • Etusnäyttö vaaditaan; taka-näyttö suositellaan, kun tämä kokemus on käytössä.
  • 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.
  • Vaihtoehtoinen kartta tarkastettu ennen kokemuksen mahdollistamista.

QA ja käynnistys

  • Testaa täydellinen asiakasmatka nykyisillä mobiililaitteilla ja työpöydällä.
  • Tarkista tuote ja variantin karttaaminen, vaatteiden valmius ja kaapelin käyttäytyminen.
  • Tarkista painopisteyhteys, keskittymisjärjestys, saatavilla olevat nimet ja palautumiskäyttäytyminen.
  • Tuote-sivun suorituskyvyn mittaaminen ennen ja jälkeen SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Vahvista suostumuksen kieli ja hyväksytty asiakkaan kuvan käsittely.
  • Hanki tekniikka, kauppa, QA ja brändin merkintä ennen tuotantoa.

Ongelmanratkaisua

Painiketta ei näy

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.

Valittu tuote tai variantti ilmenee

Vertaa kauppapaikan tuote ja muunnon tunnisteet lähetettyihin rekisteriin SPREEAI. Vahvista, että lähetetty pyyntö muuttuu, kun ostaja muuttaa vaihteluja.

Kokemus on hitaasti tai käytettävissä

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.

Saa kehittäjän tukea

Sähköposti support@spreeai.com ympäristö, tuote tai vaatteiden tunnus, selaimen tai vic e, lähiaikainen aikakausi, odotetut käyttäytymiset ja lisääntymisvaiheet. Älä sisällytä salaisuuksia tai asiakkaan kuvaa.

Valitse oma kieli.