SPREEAI/Rozwijający/Dokumentacja

Zbuduj z
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.

Publiczny przewodnikStrona SDK v2.1Aktualizacja w sierpniu 2026

Wybierz drogę integracji

DrogaNajlepiej dlaPierwsza akcja
Aplikacja ShopifySzybko zarządzane ustawienie StorefrontInstalacja aplikacji
Strona SDKWEB lub bezgłównaPrzeczytaj przewodnik SDK
iOS / AndroidNative Shopping aplikacjeWybierz przewodnik dla rodzin
Publiczne APIzatwierdzone przepływy robocze na stronie serweraOtwarte zatwierdzone referencje
Partnerska sieć AmazonIntegracja rynkuJuż wkrótce
Bezpieczeństwo kredytowe. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Aplikacja 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. Instalacja oficjalna SPREEAI aplikacja i wypełnienie zarządzanego przepływu zgody.
  2. Synchronizuj pierwotną grupę katalogową i przeglądaj stan gotowości produktu.
  3. Dostosuj pozycję i styling w podwójnej temacie.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Publikacja tylko po zatwierdzeniu marki i QA.

Otwórz oficjalny przewodnik Shopify na pokładzie

Szybki start z Web SDK

Używanie @ spreeai /WEB Sdk do indywidualnego umieszczania, stylowania, wydarzeń, rozmiaru i zachowania kosza.

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 Oficjalna wersja sieci Web SDK API

API dostęp

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.

Otwórz zatwierdzony publiczny odniesienie API

Zakład aktywów bazy

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Jeden strój na zdjęcie, skoncentrowany z czystych krawędzi i neutralny, nawet oświetlający.
  • Wizja przednia jest wymagana; wizja powrotna zalecana, gdy ta doświadczenie jest dołączone.
  • 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.
  • Opcje mapowania sprawdzone przed ułatwieniem doświadczenia.

QA i uruchomienie

  • Test pełnej podróży klienta na bieżących przeglądarkach mobilnych i desktopowych.
  • Sprawdź produkt i mapowanie wariantów, gotowość do odzieży i zachowanie koszyka.
  • Sprawdź dostęp do klawiatury, porządek koncentracji, dostępne nazwy i zachowanie padback.
  • - pomiary wydajności strony produktu przed i po umożliwieniu SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Potwierdzenie języka zgody i zatwierdzone przetwarzanie obrazu klienta.
  • Zdobądź inżynierię, handel, QA i markę przed produkcją.

Rozwiązywanie problemów

Przycisk nie pojawia się

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.

Nieprawidłowy produkt lub wariant pojawia się

Porównaj produkt i identyfikatory wariantów z rekordami wysłanymi do SPREEAI. Potwierdź, że złożone żądanie zmienia się, gdy kupujący zmienia warianty.

Doświadczenie jest wolne lub niedostępne

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.

Zdobądź wsparcie dla deweloperów

E-mail support@spreeai.com z środowiskiem, produktem lub identyfikatorem odzieży, przeglądarką lub vic e, przybliżony czas, oczekiwane zachowanie i etapy rozmnażania. Nie zawierać tajemnic ani obrazów klientów.

Wybierz swój język.