سبري آي/المطورين/توثيق

بناء مع
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

اختيار مسار التكامل

الطريقأفضل منأول عمل
تطبيق شوبيفايإعدادات متجر سريع الإدارةتثبيت التطبيق
مجموعة أدوات تطوير البرمجيات للويبالويب المخصص أو غير المكتوباقرأ دليل SDK
iOS / Androidالتطبيقات التسوقية الأصليةاختيار دليل الأصلي
واجهات برمجة التطبيقات العامةتدفقات العمل المعتمدة على جانب الخادممرجع مفتوح المعتمد
شبكة شركاء أمازونالتكامل في السوققريباً
أمن الاعتماد. 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.

  1. إعداد المسؤول SPREEAI تطبيق وإكمال تدفق الموافقة المدار.
  2. تصفية مجموعة الكتالوج الأولية ومراجعة حالات الاستعداد للمنتج.
  3. تخصيص وضع وتصميم في موضوع مزدوج.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. لا تنشر إلا بعد الموافقة على العلامة التجارية و QA.

افتح دليل Shopify الرسمي على الطيران

البدء السريع لـ Web SDK

استخدام @ spreeai WEB - 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

إطلاق النار

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.
  • 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.
  • تحقق من الوصول إلى لوحة المفاتيح، وتركيز الأوامر، والأسماء المتاحة والسلوك السقوط.
  • قياس أداء صفحة المنتج قبل وبعد 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 (هـ) المدة الزمنية التقليدية والسلوك المتوقع ومراحل التكاثر. لا تضع في اعتبارك أسرار أو صور العملاء.

اختر لغتك