สปรีไอบี/ผู้พัฒนา/เอกสารคู่มือ

สร้างด้วย
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.

คู่มือสาธารณะเว็บ SDK v2.1ปรับปรุง สิงหาคม 2026

เลือกเส้นทางการรวมกัน

ถนนดีที่สุดสําหรับการกระทําครั้งแรก
แอปพลิเคชัน Shopifyการตั้งค่าหน้าร้านขายที่จัดการได้อย่างรวดเร็วติดตั้งแอป
เว็บ SDKเว็บไซต์ที่กําหนดเองหรือไม่มีหัวอ่านคําแนะนํา SDK
iOS / Androidแอปพลิเคชันการซื้อที่บ้านเลือกคู่มือชาวบ้าน
API สาธารณะการทํางานที่ผ่านการรับรองจากเซิร์ฟเวอร์คําอธิบายที่เปิดเผย
เครือข่ายพาร์ทเนอร์ของอเมซอนการรวมตลาดเร็วๆ นี้
ความปลอดภัยการรับรอง 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. Customize การวางและ styling ในธีมแบบคู่
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. โพสต์เฉพาะหลังจากที่แบรนด์และ QA ได้รับการอนุมัติ

เปิดคู่มือการจอดเรือ Shopify อย่างเป็นทางการ

เริ่มต้นใช้งาน Web SDK อย่างรวดเร็ว

ใช้ @ spreeai /websdk สําหรับการวางตําแหน่งที่กําหนดเองการออกแบบกิจกรรมการจัดขนาดและการกระทําของรถ

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 ภาษาไทย ภาษาไทย

การเข้าถึงไฟ

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 สาธารณะที่ได้รับการอนุมัติ

เคล็ดลับ Asset Baseline

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • One garment per image, centered with clean edges and neutral, even lighting.
  • หน้าหน้าที่ต้องการ; หน้าที่แนะนําเมื่อประสบการณ์นั้นเปิดใช้งาน
  • 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 และเปิดตัว

  • ตรวจสอบการเดินทางของลูกค้าทั้งหมดบนเบราว์เซอร์มือถือและเครื่องคอมพิวเตอร์ปัจจุบัน
  • Verify product and variant mapping, garment readiness and cart behavior.
  • ตรวจสอบการเข้าถึงแท็บเล็ตคําสั่งความเข้มข้นชื่อที่สามารถเข้าถึงได้และพฤติกรรม Fallback
  • การวัดประสิทธิภาพของหน้าผลิตภัณฑ์ก่อนและหลังการใช้งาน SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • การยืนยันภาษาการยอมรับและการจัดการภาพของลูกค้าที่ได้รับการอนุมัติ
  • รับวิศวกรรมการค้า QA และแบรนด์ sign-off ก่อนการผลิต

การแก้ไขปัญหา

ปุ่มไม่ปรากฏ

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 ด้วยสภาพแวดล้อมผลิตภัณฑ์หรือเครื่องแต่งกาย ID, Browser หรือ vic e, ทัศนาประมาณการพฤติกรรมที่คาดหวังและขั้นตอนการทําลาย อย่ารวมความลับหรือภาพของลูกค้า

เลือกภาษาของคุณ