SPREEAI/vývojáři/Dokumentace

Budujte se s
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.

veřejný průvodceWebová SDK v2.1Aktualizace v srpnu 2026

Vyberte si integrační cestu

CestaNejlepší proPrvní akce
Aplikace ShopifyRychle spravované nastaveníInstalace aplikace
Webové SDKWebové stránky bez hlavy nebo webové stránkyPřečtěte si průvodce SDK
iOS / AndroidNative Shopping aplikaceVyberte si rodný průvodce
Veřejná APISchválené serverové pracovní tokyOtevřená schválená reference
Partnerská síť AmazonuIntegrace trhuJiž brzy
a bezpečnostní pověření. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Aplikace 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. Instalace úředníka SPREEAI aplikace a dokončit řízený souhlasový tok.
  2. Synchronizujte počáteční skupinu katalogu a přezkoumejte stav připravenosti produktu.
  3. Vlastníme umístění a stylování v duplikovaném tématu.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Publikovat pouze po schválení značky a QA.

Otevřete oficiální průvodce Shopify na palubě

Rychlý start s Web SDK

Použití @ spreeai Webová stránka Sdk pro přizpůsobené umístění, stylování, události, rozměry a chování vozíku.

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 Oficiální web SDK API reference

API přístup

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.

Otevřete schválenou referenční veřejnou API

Oblečení majetku bazénu

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Jeden šatník na obrázek, soustředěný s čistými okraji a neutrálním, dokonce i osvětlením.
  • Přední zobrazení je nutné; zpětní zobrazení se doporučuje, když je tato zkušenost aktivována.
  • 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 mapování zkontrolován před umožněním zkušenosti.

QA a start

  • Testujte kompletní cestování zákazníků na aktuálních mobilních a desktopových prohlížečích.
  • Zkontrolujte produkt a variantu mapování, připravenost oblečení a chování košíku.
  • Zkontrolujte přístup k klávesnici, zaměřte se na pořadí, dostupné jména a chování zpět.
  • Měření výkonu produktové stránky před a po umožnění SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Potvrzení souhlasu jazyka a schválené zpracování obrazu zákazníka.
  • Získejte inženýrství, obchod, QA a značku před výrobou.

Řešení problémů

Nástup tlačítka se nezobrazuje

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.

Zobrazí se nesprávný produkt nebo varianta

Porovnejte produkt a ID varianty před obchodem s záznamy zaslanými na SPREEAI. Potvrzujte, že se předložené požadavky mění, když kupující změní varianty.

Zkušenosti jsou pomalé nebo nedostupné

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.

Podpora vývojářů

E-mail support@spreeai.com s identifikátorem prostředí, výrobku nebo oblečení, prohlížečem nebo vic e, přibližný časový rozsah, očekávané chování a reprodukční kroky. Neobsahujte žádné tajemství ani zákazní snímky.

Vyberte si svůj jazyk.