Tài liệu

SDK 2.0 · THAM KHẢO

Tham chiếu API Web SDK

Bề mặt tích hợp công khai đã được xác minh dựa trên gói npm v3.0.0.

init(options)

trả lại Promise<SpreeAISDK | null>. Khi thành công, đối tượng lộ diện renderTryOnButton(options): Promise<void>. Kiểm tra null trước khi kết xuất.

Tùy chọnLoạiMặc địnhMục đích
clientIdstringBắt buộcSố nhận dạng ứng dụng khách của trình duyệt đã được cấp.
baseApiURLstringhttps://api.spreeai.comNguồn gốc API được phê duyệt. Chỉ thay đổi đối với môi trường đã ban hành.
baseURLstringhttps://vton.spreeai.comNguồn gốc phòng thử đồ được lưu trữ đã được phê duyệt.

partnerId không phải là một tùy chọn init trong v3. Đối tác được giải quyết từ khách hàng được xác thực. Không có phương thức kết xuất kích thước độc lập nào được trả về.

renderTryOnButton(options)

Tùy chọnLoạiMặc định/yêu cầuMục đích
elementIdstringBắt buộcID của phần tử máy chủ hiện có.
garmentsGarmentInput[]Lựa chọn bắt buộcĐầu vào may mặc được đề xuất. Sử dụng một mảng không trống.
garmentIdstringGiải pháp thay thế không được dùng nữaĐầu vào đơn hàng kế thừa. Ưu tiên hàng may mặc.
variantVariantOptionsKhông được dùng nữaBộ lọc kế thừa với garmentId; thích biến thể cho mỗi mục.
classNamestringKhông bắt buộcLớp nút bổ sung.
button{ text?: string }Không bắt buộcNhãn nút; bị ghi đè bởi features.tryOnButton.text.
featuresTryOnFeaturesKhông bắt buộcCấu hình kiểu dáng nút.
eventsTryOnButtonEventsKhông bắt buộcTrình xử lý nhấp chuột và thêm vào giỏ hàng.
enableAddToCartbooleanfalseHiển thị chức năng thêm vào giỏ hàng. Thực hiện trình xử lý.
enableSizingRecommendationbooleanfalseYêu cầu đề xuất kích thước khi thử.
showSizesbooleanfalseHiển thị availableSizes được cung cấp.
showPricesbooleanfalseHiển thị giá cung cấp.
defaultUnits"metric" | "imperial"Không bắt buộcHệ thống đơn vị khởi đầu để đo biên dạng.

GarmentInput

trườngLoạiMục đích
garmentIdstringBắt buộc phải có số nhận dạng quần áo SPREEAI.
variantVariantOptionsBộ lọc màu sắc, độ vừa vặn, giới tính hoặc kiểu dáng tùy chọn.
availableSizesstring[]Nhãn kích thước hiển thị hiện tại tùy chọn.
pricestringGiá hiển thị tùy chọn, hiển thị như được cung cấp.

Xác thực và dự phòng

Đối với một sản phẩm may mặc, tính đủ điều kiện và mọi biến thể được ghim đều được kiểm tra trước khi kết xuất. Các yêu cầu về nhiều loại quần áo sẽ tìm kiếm một bộ trang phục phù hợp có sẵn. Nếu không tìm thấy, SDK sẽ xác thực và hiển thị trang phục đầu tiên. Nếu xác thực không thành công, không có nút nào được hiển thị và lý do được ghi vào bảng điều khiển.

Cuộc gọi lại

Gọi lạiTải trọng
onTryOnButtonClickname: "spreeai-try-on-button-clicked"
onAddToCartClickedname: "spreeai-add-to-cart-clicked", hàng may mặc, setIsLoading, closePopUp, onError

Giỏ hàng may mặc chứa yêu cầu id, partner_id, available Và name, cộng thêm tùy chọn description và các dữ liệu khác. Xác thực trước khi ánh xạ tới giỏ hàng của bạn. Xem thực hiện giỏ hàng Và kiểu dáng nút để biết ví dụ.

Không phải là một phần của bề mặt này

Không có tài liệu chuyển đổi cho mỗi chế độ xem, trình khởi chạy So sánh độc lập hoặc phương pháp định cỡ độc lập nào được hiển thị trên SDK v3.0.0 được trả về. features.loadingScreen đã được gỡ bỏ. Không suy ra các phương thức có thể gọi được từ các loại đã xuất còn sót lại hoặc các nhận xét cũ.

Nguồn tham khảo

Tìm kiếm tiêu đề và nội dung trang. Thoát kết thúc tìm kiếm.

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