SPREEAI/Développeurs/Documentaire

Construire avec
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.

Guide publicWeb SDK v2.1Mise à jour en août 2026

Choisir le chemin d’intégration

PathLe meilleur pourPremière action
Application ShopifyDéveloppement rapide de la boutiqueInstaller l’app
Kit de développement logiciel WebWeb personnalisé ou sans rubriqueLire la guide SDK
iOS / AndroidAppes de shopping nativesChoisir un guide natif
API publiquesLes flux de travail du côté serveur approuvésUne référence ouverte approuvée
Réseau de partenaires AmazonIntégration du marchéBientôt disponible
Sécurité de la crédibilité. Examples use placeholders only. SPREEAI issues approved access during onboarding. Never publish a client secret, API key, token, private hostname or customer data.

Application 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. Installez le fonctionnaire SPREEAI App et complète le flux de consentement géré.
  2. Synchroniser un groupe de catalogue initial et réviser les états de prédisposition du produit.
  3. Customiser la position et le styling dans un thème dupliqué.
  4. Validate eligible products, variants, mobile behavior and add-to-cart.
  5. Il n'est publié que après la marque et l'approbation QA.

Ouvrez le guide officiel de l'embarquement Shopify

Démarrage rapide du SDK Web

Utiliser @ spreeai /WEB et SDA pour la placement personnalisée, le styling, les événements, la taille et le comportement de carton.

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 Le site officiel SDK API

Accès à l’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.

Ouvrir la référence API publique approuvée

Asset de base

  • JPEG or PNG; 2,000 × 2,000 px minimum, with approximately 4K preferred.
  • Un vêtement par image, centré avec des bords propres et neutres, même éclairage.
  • Vue avant requise; Vue arrière recommandée lorsque cette expérience est activée.
  • 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.
  • La carte de variante a été vérifiée avant d'autoriser l'expérience.

QA et lancement

  • Testez le voyage complet des clients sur les navigateurs mobiles et de bureau actuels.
  • Vérifiez le produit et la cartographie des variantes, la préparation des vêtements et le comportement de la chaise.
  • Vérifiez l’accès au clavier, l’ordre de focalisation, les noms accessibles et le comportement de descente.
  • Mesurer la performance de la page du produit avant et après l'engagement SPREEAI.
  • Exercise loading, empty, unavailable, timeout and retry states.
  • Confirmation du langage de consentement et traitement approuvé de l'image client.
  • Obtenez l'ingénierie, le commerce, la QA et la marque sign-off avant la production.

Dépannage

Le bouton ne apparaît pas

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.

Le produit ou la variante incorrecte apparaît

Comparaison du produit de la boutique et des identifiants variantes avec les enregistrements envoyés à SPREEAI. Confirmez que la demande rendue change lorsque le acheteur change les variantes.

L’expérience est lente ou inaccessible

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.

Obtenez le soutien de développeur

Courriel support@spreeai.com avec l’environnement, le produit ou le ID de vêtement, le navigateur ou vic e, le timing approximatif, les étapes de comportement et de reproduction attendues. Ne pas inclure des secrets ou des images client.

Choisissez votre langue.