SPREEAI/Dezvoltatori/Documentare

Construit cu
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.

Ghidul publicCuvânt cheie SDK v2.1Actualizat în august 2026

Alegerea căii de integrare

CaleaCel mai bun pentruPrima acțiune
Aplicație ShopifySetare rapidă de managementInstalarea aplicației
SDK WebWeb personalizat sau fără capCitiți ghidul SDK
iOS / AndroidAplicații de cumpărături nativeAlege un ghid nativ
APIs publicFluxuri de lucru aprobat de server-sideReferință deschisă aprobată
Rețeaua de parteneri AmazonIntegrarea pieţeiVino în curând
securitatea de credenţială. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Aplicație Shopify

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. Instalarea oficialului SPREEAI aplicarea și completarea fluxului de consimțământ gestionat.
  2. Sync un grup de catalog inițial și evaluarea statelor de disponibilitate a produsului.
  3. Personalizează poziția și stilul într-o temă duplicată.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Publică numai după marcă și QA aprobare.

Deschideți ghidul oficial Shopify onboarding

Web SDK pentru start rapid

Utilizarea @ spreeai /SdC pentru plasarea personalizată, stilul, evenimentele, dimensiunile și comportamentul cartierului.

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 Site-ul oficial de referință SDK API

Accesul la API

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.

A se deschide referința API publică aprobată

Baza de acțiune de îmbrăcăminte

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Un costum pe imagine, centrat cu margini curate și neutre, chiar și iluminare.
  • Vizualizare frontală necesară; vizualizare retro recomandată atunci când această experiență este activată.
  • 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.
  • Varianta de hărțuire verificat înainte de a permite experiența.

QA și lansare

  • Testarea întregii călătorii clienților pe browserele mobile și desktop actuale.
  • Verificați produsul și cartografierea variantei, pregătirea hainelor și comportamentul cartușului.
  • Verificați accesul la tastatură, ordinea de focalizare, numele accesibile și comportamentul de descărcare.
  • Măsurarea performanței paginii produsului înainte și după utilizare SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Confirmă limba consimțământului și manipularea autorizată a imaginii clientului.
  • Obțineți inginerie, comerț, QA și brand-off înainte de producție.

rezolvarea problemelor

Butonul nu apare

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.

Se pare produsul sau varianta greșită

Comparați produsul de pe magazin și ID-urile variante cu înregistrările trimise la SPREEAI. Confirmă că cererea prezentată se schimbă atunci când cumpărătorul schimbă variante.

Experiența este lentă sau inaccesibilă

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.

Obțineți sprijin de dezvoltare

E-mail support@spreeai.com cu mediul, produsul sau ID-ul de îmbrăcăminte, browserul sau vic e, intervalul de timp aproximat, comportamentul așteptat și etapele de reproducere. Nu includeți secretele sau imaginea clientului.

Alegeți limba ta.