Bientôt sur le réseau Amazon Partner et d'autres plateformes, avec plus de façons d'intégrer SPREEAI dans votre boutique de commerce.Les mises à jour apparaîtront ici en premier

Démarrage rapide du SDK Web

Votre première intégration.

Authentifiez-vous une seule fois, puis affichez l'essayage virtuel ou le choix des tailles n'nimporte où sur la page. Utilisez les identifiants de test fournis lors de l'intégration et ne placez jamais de secret client dans le code du navigateur.

npm install @spreeai/web-sdk

# ou
yarn add @spreeai/web-sdk

import { init } from "@spreeai/web-sdk";

const sdk = await init({
  clientId: "your-client-id",
  partnerId: "your-partner-id",
});

if (sdk) {
  await sdk.renderTryOnButton({
    elementId: "spreeai-try-on",
    garments: [{ garmentId: "your-garment-id" }],
    enableAddToCart: true,
  });
}

events: {
  onTryOnButtonClick: (event) => {
    analytics.track("try_on_started", event);
  },
  onAddToCartClicked: async (event) => {
    // Connectez-vous à votre flux de panier existant.
  },
}

Le modèle d'intégration

Quatre systèmes.
Un moment client.

01Votre catalogue

Identifiants de produits, variantes, imagerie et contexte de marchandisage.

02intégration SPREEAI

Les vêtements passent par des états de traitement, de révision et de préparation.

03SDK ou API

Votre vitrine demande l'expérience pour un produit éligible.

04Action client

Essayez, trouvez votre taille, complétez votre look et retournez au paiement.

Un chemin focalisé pour lancer

Préparer. Connectez
Vivez avec confiance.

Trois kilomètres, avec une liste de contrôle pratique pour chacun.

01 - Préparation
Un point de départ clair.
Alignez le voyage, l’accès et le catalogue.
Préparation de la liste de contrôle
- Choisissez un canal, un groupe de catalogue et une mesure de succès.
- Confirmez l'accès des partenaires, les credentials et les permis de staging.
- Fournir une image de vêtements propre et SKU-alignée.
Produits · Ingénierie · Catalogue
02 - Connectez
Faites-le sentir natif!
Construit en étage. Testez toute la route.
Liste de contrôle d'intégration
- Render pour les produits éligibles et connecter les variantes et le comportement de la carton.
- Comparaison de l’expérience avec la marque.
- Vérifiez les stades de téléphone portable, de bureau, d'accessibilité, de performance et d'échec.
Front-end · QA · Marque
03 - Démarrage
Apprendre à l’usage réel.
- La mise en place de produits et de mesure.
Démarrer la liste de contrôle
- Confirmez la disponibilité du produit et publiez l'expérience établi.
- - Contrôle de l’adoption, de la finition et de la conversion.
- Utilisez les résultats pour guider la prochaine catégorie ou le voyage.
Commerce · Analyse

Référence d'actif

Une bonne entrée donne un meilleur résultat.

JPEG ou PNG
2 000 × 2 000 px minimum
Vue de face requise
Vue de dos recommandée
Éclairage neutre et uniforme
UGS ou ID de style dans le nom de fichier

Ouvrir la liste de vérification des actifs

Référence développeur

Trouver le suivant
réponse utile.

/

Commencer ici

Premiers pas

Comprendre l'accès, les plateformes prises en charge et les premières décisions que votre équipe doit prendre.

référence officielle Intégration gérée

Intégration Shopify

Installez l'application, acceptez les conditions, synchronisez les vêtements, personnalisez le bouton et lancez-vous.

référence officielle Kit de développement logiciel Web

Surface d'API

Examiner l'initialisation, les options de rendu, le dimensionnement, la personnalisation et les interfaces typées.

référence officielle API Partenaire

Référence de l'API publique

Explorez l'interface approuvée côté serveur mise à la disposition des partenaires authentifiés.

Référence de Swagger Qualité

Actifs de vêtements

Préparez les images et les métadonnées des produits pour qu'elles passent facilement par l'ingestion et l'examen.

SPREEAI Guide Production

AQ et lancement

Utilisez la liste de contrôle partagée pour le navigateur, les performances, l'accessibilité et le lancement.

SPREEAI Guide soutien

Dépannage

Résolvez les problèmes les plus courants d'authentification, d'éligibilité, de rendu et de performance.

SPREEAI Guide Documentaire

Guides d'implémentation

Parcourez les guides de démarrage rapide publics, les normes d'actifs, les listes de contrôle de lancement et les conseils de dépannage.

Documents ouverts

Créer pour la production

Les détails qui protègent
l'expérience client.

Sécurité

Gardez les secrets côté serveur, n'utilisez que les environnements émis et faites pivoter les identifiants via le flux de travail du partenaire.

Confidentialité

Demandez des images de clients avec un consentement explicite et alignez le traitement des données sur votre plan d'intégration approuvé.

Performance

Chargez l'expérience là où c'est nécessaire, testez de vrais appareils et surveillez les régressions des pages de produits.

Accessibilité

Préserver l'accès au clavier, l'ordre de focalisation, les noms accessibles et un parcours utilisable lorsque l'expérience est indisponible.

FAQ développeur

Questions avant
le premier commit.

Quelle intégration devrions-nous choisir ?

Utilisez l'application Shopify pour le parcours géré le plus rapide, le SDK Web pour les intégrations web personnalisées ou sans tête (headless), les SDK natifs pour les expériences in-app, et la référence d'API approuvée pour les flux de travail côté serveur convenus lors de l'intégration.

D'où viennent les justificatifs d'identité ?

SPREEAI émet l'identifiant partenaire et les identifiants approuvés lors de l'intégration. Le SDK du navigateur utilise un identifiant client et un identifiant partenaire. N'intégrez jamais de secret client dans le code frontal.

L'application Shopify nécessite-t-elle des clés API ?

Le parcours d'intégration actuel de l'application Shopify connecte la boutique après l'étape des accords requis et de l'abonnement ; l'application gérée ne nécessite pas de copier les clés dans l'écran de configuration.

Pourquoi le bouton Essayage n'apparaît-il pas ?

Confirmez que le vêtement a terminé son traitement, qu'il est activé pour l'essayage virtuel, qu'il est associé au produit ou à la variante actif, et que le bloc d'application ou le conteneur SDK est présent sur le modèle de produit.

Quels événements client sont disponibles ?

Les rappels du SDK documentés couvrent les clics sur le bouton d'essayage et les interactions d'ajout au panier. Connectez-les à votre couche d'analyse sans inclure d'images de clients ni de données personnelles inutiles.

Les webhooks de serveur sont-ils disponibles ?

Les webhooks de type server-push ne font pas partie de la documentation du SDK actuellement publiée. Validez toute exigence d'événement côté serveur auprès de l'équipe d'ingénierie partenaire avant de vous y fier.

Où les développeurs trouvent-ils de l'aide ?

Utilisez le canal de support technique fourni lors de l'intégration ou par e-mail support@spreeai.com. Incluez l'environnement, l'identifiant du produit, le navigateur ou l'appareil, l'horodatage et un chemin de reproduction concis — n'envoyez jamais de secrets.

Quand le support du réseau de partenaires Amazon sera-t-il disponible ?

L'intégration au réseau de partenaires Amazon est en cours de développement. Elle est intentionnellement marquée comme « Bientôt disponible » jusqu'à ce que l'interface d'intégration et de production soit prête pour les développeurs externes.

Prêt à construire ?

Choisissez le chemin.
Nous vous aidons à l'expédier.

Réserver une découverte technique Télécharger tous les docs Le parcours ouvert des partenaires

Construis la cabine d'essayagedans chaque écran.

Commencez là où votreLa pile de commerce vit.

Application Shopify

Kit de développement logiciel Web

Kit de développement logiciel iOS

SDK Android

API publiques

Réseau de partenaires Amazon

Votre première intégration.

Quatre systèmes.Un moment client.

Préparer. ConnectezVivez avec confiance.

Un point de départ clair.

Faites-le sentir natif!

Apprendre à l’usage réel.