스프리AI/개발자/문서화

건설을 통해서
스프리AI.

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.

공공 가이드웹 SDK v2.1업데이트 2026년 8월

통합 경로를 선택하십시오

길이최고의 를 위해첫 행동

쇼피파이 앱빠른 관리 스토어 프론트 설정앱 설치

웹 SDK사용자 지정 또는 헤드없는 웹SDK 가이드를 읽으십시오.

안드로이드 / Android원주민 쇼핑 앱원주민 가이드를 선택하십시오

공공 APIs서버 측 작업 흐름 승인오픈 승인된 참조

아마존 파트너 네트워크시장 통합곧 오게 될

신뢰성 안전 Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

쇼피파이 앱

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.

공무원 설치 SPREEAI 앱 및 관리 된 동의 흐름을 완료합니다.
초기 카탈로그 그룹을 동기화하고 제품 준비 상태를 검토합니다.
두 배의 테마에 대한 배치와 스타일링을 사용자 정의하십시오.
Validate eligible products, variants, mobile behavior and add-to-cart.
브랜드 및 QA 승인 후에만 게시됩니다.

Shopify 공식 항해 가이드를 열어보세요

웹 SDK 빠른 시작

사용하기 @ spreeai 웹 Sdk 사용자 지정 배치, 스타일링, 이벤트, 크기 및 카트 행동을 위해.

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 참조

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 및 발사

현재의 모바일 및 데스크톱 브라우저에서 전체 고객 여행을 테스트합니다.
제품 및 변형 지도, 옷 준비 및 카트 행동을 확인합니다.
키보드 액세스, 초점 순서, 접근 가능한 이름 및 Fallback 행동을 확인합니다.
제품 페이지 성능을 측정하기 전과 후 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.

잘못된 제품 또는 변형이 나타납니다.

상점 앞 제품 및 변수 ID를 보내는 기록과 비교하세요. 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 환경, 제품 또는 옷 ID, 브라우저 또는 vic e, 대략적인 시간표, 예상 행동 및 재생 단계. 비밀이나 고객 이미지를 포함하지 마십시오.

개발자 집 기술적 발견 책

건설을 통해서스프리AI.