SPREEAI/Vývojáři/Dokumentace

Sestavte s
SPREEAI.

Praktická cesta od volby integrace k testovanému spuštění. Začněte s jednou obchodní cestou, použijte vydaný testovací přístup a vyhněte se přihlašovacím údajům v kódu prohlížeče.

Veřejný průvodceWebová SDK v3.0.0Aktualizováno v říjnu 2026

Vyberte cestu integrace

CestaNejlepší proPrvní akce
Shopify AplikaceRychlé a spravované nastavení prodejnyNainstalujte si aplikaci
Webová SDKVlastní nebo bezhlavý webPřečtěte si průvodce SDK
iOS / AndroidNativní nákupní aplikaceVyberte si rodilého průvodce
Veřejná APISchválené pracovní postupy na straně serveruOtevřít schválenou referenci
Partnerská síť AmazonuIntegrace s tržištiJiž brzy
Bezpečnost pověření. Příklady používají pouze zástupné symboly. SPREEAI vydává schválený přístup během registrace. Nikdy nezveřejňujte tajný klíč klienta, klíč API, token, název soukromého hostitele ani zákaznická data.

Shopify Aplikace

Používejte spravovanou aplikaci, když obchod běží na Shopify a nepotřebuje vlastní backend. Aktuální proces onboardingu propojuje obchod po uzavření smluv a předplatného; nevyžaduje kopírování klíčů API do obrazovky nastavení.

  1. Nainstalujte si oficiální aplikaci SPREEAI a dokončete proces spravovaného souhlasu.
  2. Synchronizujte počáteční skupinu katalogů a zkontrolujte stavy připravenosti produktů.
  3. Přizpůsobte si umístění a styl v duplikovaném motivu.
  4. Ověřte vhodné produkty, varianty, chování na mobilních zařízeních a přidání do košíku.
  5. Publikovat až po schválení značky a kontroly kvality.

Otevřít oficiálního průvodce pro zaškolení v Shopify

Rychlý start pro webové SDK

Použití @spreeai/web-sdk pro vlastní umístění, styling, události, velikosti a chování košíku.

npm install @spreeai/web-sdk@3.0.0

import { init } from "@spreeai/web-sdk";
import "@spreeai/web-sdk/dist/web-sdk.css";

// Add <div id="spreeai-try-on"></div> to the product page first.
const sdk = await init({ clientId: "your-client-id" });

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

Inicializujte jednou, vykreslete pouze pro vhodný produkt a propojte zdokumentované zpětné volání klientů s vaší stávající analytikou. Potvrďte aktuální rozhraní v oficiální referenční příručka k webovému rozhraní SDK API

Přístup k API

Veřejnou referenci Swagger používejte pouze pro pracovní postupy na straně serveru schválené během zavádění. Udržujte tajné informace na serveru, oddělte testovací a produkční přístup a přihlašovací údaje upravte na minimální požadované prostředí.

Přímé koncové body REST, webhooky nebo ověřovací chování, které nejsou přítomny ve schválené veřejné referenci, by měly být považovány za nedostupné, dokud je nepotvrdí partnerský technický tým.

Otevřete schválenou referenci veřejného API

Základní stav aktiv oděvů

  • JPEG nebo PNG; minimálně 2 000 × 2 000 pixelů, preferováno přibližně 4K.
  • Jeden oděv na obrázek, vycentrovaný s čistými okraji a neutrálním, rovnoměrným osvětlením.
  • Pohled zepředu je vyžadován; pokud je tato funkce povolena, doporučuje se pohled zezadu.
  • Stabilní SKU, styl nebo ID oděvu zahrnuté v názvu souboru a záznamu katalogu.
  • Žádné ruce, ramínka, stylingové rekvizity, vodoznaky ani nesouvisející oděvy, které by blokovaly položku.
  • Před aktivací prostředí bylo zkontrolováno mapování variant.

Kontrola kvality a spuštění

  • Otestujte kompletní zákaznickou cestu v aktuálních mobilních a stolních prohlížečích.
  • Ověřte mapování produktů a variant, připravenost oděvů a chování košíku.
  • Zkontrolujte přístup z klávesnice, pořadí fokusu, přístupné názvy a chování při záložních funkcích.
  • Změřte výkon stránky produktu před a po aktivaci SPREEAI.
  • Stavy načítání cvičení, prázdné, nedostupné, časový limit a opakování.
  • Potvrďte znění souhlasu a schválené nakládání se snímky zákazníka.
  • Před zahájením výroby si zajistěte schválení inženýrských, obchodních, kontrolních a značkových pracovníků.

Odstraňování problémů

Tlačítko se nezobrazuje

Potvrďte inicializaci SDK, identifikátor klienta, ID hostitelského prvku, způsobilost produktu, připravenost oděvu a mapování variant. Poté zkontrolujte chyby konzole prohlížeče a sítě bez sdílení tokenů.

Zobrazuje se nesprávný produkt nebo varianta

Porovnejte ID produktů a variant z prodejny se záznamy odeslanými na SPREEAI. Potvrďte, že se vykreslený požadavek změní, když nakupující změní variantu.

Prostředí je pomalé nebo nedostupné

Otestujte produkt, o kterém se ví, že je připraven k testování, ověřte aktivní prostředí, zkontrolujte blokované požadavky a porovnejte čistou relaci prohlížeče. Zaznamenejte časové razítko a reprodukovatelnou sekvenci pro účely podpory.

Získejte podporu pro vývojáře

E-mail support@spreeai.com s ID prostředí, produktu nebo oděvu, prohlížečem nebo zařízením, přibližným časovým razítkem, očekávaným chováním a kroky reprodukce. Neuvádějte tajné informace ani obrázky zákazníků.

Dokumentace

Vyberte si jazyk.