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.

Громадський керівникСтворення Web SDK v2.1Оновлено: Жовтень 2026

Вибір шляху інтеграції

ШляхНайкраще дляПерша акція
Додаток ShopifyШвидко керуюча система StorefrontЗавантажити App
Веб-SDKКваліфікований або безголосний вебЧитати далі про SDK
Android / iOSІндивідуальні покупкиВибір індійського керівництва
Публічні APIСервісний робочий потікВідкритий затверджений референт
Партнерська мережа AmazonІнтеграція ринкуНезабаром
Кредитна безпека Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Додаток 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. Встановлення офіційного SPREEAI Завантажити та завершити управляний потік згоди.
  2. Сінкуруйте початкову групу каталогу та перегляньте стати готовості продукту.
  3. Налаштуйте розташування та стилінг в подвійній темі.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Видавати тільки після бренду і QA затвердження.

Відкрийте офіційний посібник Shopify

Швидкий старт із Web SDK

Використання @ spreeai WEB - СДК для пристосованого розміщення, стилювання, подій, розмірювання та поведінки кошика.

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 Офіційний сайт SDK 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.

Відкрийте затверджений публічний API-референт

Базальні активи

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Один одяг на зображення, зосереджений з чистими краями і нейтральним, навіть освітленням.
  • Потрібна передня перегляд; рекомендується зворотна перегляд, коли ця досвід включена.
  • 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.
  • Варіант-папінг перевірено до того, як дозволили досвід.

QA і запуску

  • Тестуйте повну подорож клієнта на поточних мобільних та робочих браузерів.
  • Перевірте продукцію та варіантний мапінг, готовність одягу та поведінку кошика.
  • Перевірте доступ до клавіатури, фокус замовлення, доступні імена та поведінку падіння.
  • Вимірювання продуктивності сторінки продукту до і після дозволу SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Підтвердити мову згоди та затверджений обробка клієнтської зображення.
  • Отримайте інженерну, торговельну, QA і марку підписання перед виробництвом.

Усунення несправностей

Кнопка не з'являється

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.

Поясніть неправильний продукт або варіант

Порівняйте товар і ідентифікатори варіантів з записами, надісланими до SPREEAI. Поверніть, що поданий запит змінюється, коли покупець змінює варіанти.

Досвід повільний або недоступний

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.

Допомога розробника

Електронна пошта support@spreeai.com з екологією, продуктом або ідентифікатором одягу, браузером або vic e, приблизний час, очікувані поведінки та етапи розмноження. Не включайте таємниці або зображення клієнтів.

Виберіть свій мову.