Identifiants et environnements#
Configurez les identifiants pour votre boutique en ligne Visualizer SDK et, si nécessaire, pour l’interface Product Import API. La lecture de la documentation publique ne crée pas d'identifiant et ne donne pas accès à une boutique.
Où utiliser chaque identifiant ?#
| Intégration | Identifiant | Emplacement prévu |
|---|---|---|
| SDK de la boutique en ligne | Shop ID et Publishable Key | Attributs de script du SDK de la boutique en ligne |
| Product Import API | Client ID et Client Secret | Votre backend ou une tâche sécurisée côté serveur |
Une Publishable Key est destinée au navigateur. Un Client Secret doit rester sur votre serveur. Ne les copiez jamais dans un thème, un Markdown public, un bundle client ou une capture d'écran du support.
Obtenir et configurer les identifiants#
Ouvrez le tableau de bord marchand, sélectionnez la bonne boutique et examinez l'intégration SDK et les Paramètres. Suivez les instructions de démarrage pour Client ID et Client Secret.
Configurer les Allowed Origins (CORS)#
Avant de tester ou de publier le SDK, ouvrez Dashboard → Settings pour la boutique correcte et trouvez Allowed Origins (CORS).
- Saisissez les origines des boutiques en ligne qui chargeront le SDK, séparées par des virgules. Par exemple :
https://example.com, https://www.example.com, https://shop.example.com. - Utilisez le protocole et l'hôte, plus le port si applicable, sans chemin de page, chaîne de requête ni fragment. Ajoutez aussi votre origine de prévisualisation ou de préproduction si vous testez le SDK là-bas ; n'utilisez
http://localhost:3000que lorsque c'est votre origine de test local réelle. - Cliquez sur Enregistrer, puis rechargez la boutique en ligne et testez à nouveau le SDK.
Vérifiez l’URL exacte que les clients visitent : https://example.com et https://www.example.com sont des origines différentes. Un test local ou de prévisualisation réussi ne garantit pas que l'origine publiée est configurée.
Remplacer les valeurs d'exemple#
Les exemples utilisent des espaces réservés tels que <SHOP_ID>, <PUBLISHABLE_KEY> et <YOUR_CLIENT_SECRET>. Remplacez-les uniquement dans l'environnement prévu. Les exemples HTML peuvent encoder les crochets angulaires comme < et > ; remplacez l'espace réservé entier, y compris cet encodage.
Environnements du SDK et de l'import de produits#
Le navigateur charge https://sdk.ideal.house/sdk.js avec le Shop ID et la Publishable Key de la même boutique. L’interface Product Import API continue d'utiliser https://sdkapi.ideal.house, avec son authentification côté serveur documentée.
Configurez séparément les origines de votre boutique en ligne de prévisualisation et de production comme décrit ci-dessus. Utilisez des produits de test préparés avant la publication, puis terminez la liste de vérification avant lancement.