SPREEAI/Nhà phát triển/Tài liệu

Xây dựng với
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.

Hướng dẫn công cộngWeb SDK v2.1Cập nhật tháng 8 năm 2026

Chọn con đường hội nhập

Đườngtốt nhất chohành động đầu tiên
Ứng dụng ShopifyCài đặt nhanh storefrontCài đặt App
Web SDKWeb tùy chỉnh hoặc không có tiêu đềĐọc hướng dẫn SDK
iOS / AndroidỨng dụng mua sắm bản địaChọn một hướng dẫn bản địa
API công khai- Các dòng công việc server-side được chấp thuậnMục tiêu mở được phê duyệt
Mạng lưới đối tác AmazonIntegration thị trườngSắp ra mắt
an toàn tín dụng. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Ứng dụng 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. Cài đặt Official SPREEAI ứng dụng và hoàn thành dòng đồng ý được quản lý.
  2. Đồng bộ một nhóm danh mục ban đầu và xem xét các trạng thái sẵn sàng sản phẩm.
  3. Tùy chỉnh vị trí và phong cách trong một chủ đề duplicated.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Chỉ xuất bản sau khi thương hiệu và QA phê duyệt.

Mở hướng dẫn chính thức Shopify trên tàu

Bắt đầu nhanh Web SDK

Sử dụng @ spreeai Trang web Sdk cho việc đặt tùy chỉnh, phong cách, sự kiện, kích thước và hành vi xe.

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 Hướng dẫn chính thức Web SDK API

API truy cậ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.

Mở tham chiếu API công cộng được phê duyệt

Lựa chọn Asset Baseline

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Một bộ quần áo mỗi hình ảnh, tập trung với những cạnh sạch và trung lập, thậm chí là ánh sáng.
  • Phía trước được yêu cầu; Phía sau được khuyến khích khi trải nghiệm đó được bật.
  • 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.
  • Bản đồ biến thể đã được kiểm tra trước khi cho phép kinh nghiệm.

QA và khởi động

  • Kiểm tra toàn bộ hành trình khách hàng trên các trình duyệt di động và máy tính để bàn hiện tại.
  • Kiểm tra sản phẩm và bản đồ biến thể, sẵn sàng trang phục và hành vi của thùng.
  • Kiểm tra truy cập bàn phím, đặt hàng tập trung, tên có sẵn và hành vi giảm.
  • - Kiểm tra hiệu suất trang sản phẩm trước và sau khi SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Kiểm tra ngôn ngữ đồng ý và xử lý được phê duyệt của hình ảnh khách hàng.
  • Nhận kỹ thuật, thương mại, QA và thương hiệu sign-off trước khi sản xuất.

Khắc phục sự cố

nút không xuất hiện

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.

Sản phẩm hoặc biến thể sai xuất hiện

So sánh sản phẩm và ID biến thể của cửa hàng trước với các bản ghi được gửi đến SPREEAI. Kiểm tra rằng yêu cầu được thực hiện thay đổi khi người mua thay đổi biến thể.

Kinh nghiệm chậm hoặc không sẵn dùng

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.

Hỗ trợ Developer

Email support@spreeai.com với môi trường, sản phẩm hoặc ID quần áo, trình duyệt hoặc vic e, khoảng thời gian gần, hành vi dự kiến và các bước tái tạo. Không bao gồm bí mật hoặc hình ảnh khách hàng.

Chọn ngôn ngữ của bạn