Intégrations Visuality : Shopify, PrestaShop, site web et API REST

Visuality s'intègre à votre site de quatre façons : l'application Shopify, le module PrestaShop gratuit, le code iframe à coller sur n'importe quel site, et l'API REST pour les développeurs. Toutes affichent la même visionneuse 3D, avec la réalité augmentée sur iPhone et Android, sans application à installer pour vos clients.

Quelle intégration choisir ?

Application Shopify

Pour les boutiques Shopify : un bloc de thème affiche la visionneuse 3D et le QR code sur chaque fiche produit associée, sans code. Facturation par Shopify.

Découvrir l'application Shopify

Module PrestaShop

Pour PrestaShop 1.7 à 8.x : un module gratuit, connecté par votre clé API, qui affiche la 3D sur les fiches produits choisies.

Voir le module PrestaShop

Visionneuse 3D pour site web

Pour WordPress, Wix, Webflow ou tout site qui accepte du HTML : un code iframe à copier-coller, ou un lien et un QR code à partager.

Intégrer la visionneuse sur un site

API REST

Pour les développeurs : créez, modifiez et listez vos objets 3D et vos groupes par programme, puis récupérez l'URL de leur visionneuse.

Voir l'API REST

Application Shopify

Notre application Shopify est disponible sur le Shopify App Store. Elle intègre le viewer 3D et la réalité augmentée sur vos fiches produits, sans aucune ligne de code.

  • Viewer 3D interactif sur la fiche produit
  • Réalité augmentée sur mobile
  • Association de vos objets 3D à vos produits en quelques clics
  • Installation en un clic depuis votre administration Shopify
  • Facturation gérée par Shopify, sans engagement

Module PrestaShop

Notre module gratuit pour PrestaShop (1.7 à 8.x) intègre automatiquement le viewer 3D et la réalité augmentée sur vos fiches produits.

  • Viewer 3D interactif sur la fiche produit
  • QR code pour la réalité augmentée
  • 3 modes d'affichage : Viewer 3D, QR Code, ou les deux
  • Dimensions personnalisables par produit
  • Compatible multiboutique
  • Aucun appel à l'API Visuality lors de l'affichage de vos fiches produits

Visionneuse 3D sur votre site : iframe, lien et QR code

Chaque objet 3D de votre bibliothèque dispose d'une page « Visualiser / Partager » qui fournit un lien d'accès, un QR code à télécharger, le code HTML de ce QR code et un code iframe à coller dans n'importe quelle page web.


API REST

Pour une intégration personnalisée, utilisez notre API REST pour gérer vos objets 3D depuis n'importe quelle application.

Chaque requête s'authentifie avec votre clé API, transmise dans l'en-tête X-API-KEY. Les réponses sont au format JSON-LD et la documentation interactive (OpenAPI) liste toutes les opérations disponibles.

curl -H "X-API-KEY: VOTRE_CLE_API" \
     -H "Accept: application/ld+json" \
     https://visuality.fr/api/objects

Pour chaque objet, l'API renvoie notamment son nom, sa description, sa miniature, son code PIN, ses réglages d'échelle et de placement, ainsi que les URL de sa visionneuse et de son QR code en français et en anglais.

Objet 3D

  • Récupérer la liste de vos objets
  • Récupérer les informations d'un objet, dont son code pin et l'url de sa visionneuse
  • Créer un objet 3D
  • Modifier un objet 3D
  • Supprimer un objet 3D

Groupe d'objets

  • Récupérer la liste de vos groupes
  • Récupérer les informations d'un groupe, dont son code pin et l'url de sa visionneuse
  • Créer un groupe
  • Modifier un groupe
  • Supprimer un groupe
  • Ajouter un objet 3D au groupe
  • Retirer un objet 3D du groupe

Questions fréquentes

Connectez-vous à votre compte, puis ouvrez la page Intégration du menu : votre clé API s'affiche dans l'encadré « Clé API », avec un bouton pour la copier. Elle sert notamment au module PrestaShop et aux appels à l'API REST.

L'ancienne clé cesse immédiatement de fonctionner. Mettez à jour chaque outil qui l'utilisait, par exemple le module PrestaShop ou vos scripts d'appel à l'API, sinon ils ne pourront plus accéder à vos objets 3D.

Ajoutez l'en-tête X-API-KEY, avec votre clé, à chaque requête envoyée vers /api. Vous pouvez aussi obtenir un jeton JWT en envoyant votre e-mail et votre mot de passe à /authAPI, puis le transmettre dans l'en-tête Authorization. La documentation interactive se trouve sur /api.

Oui. Le module PrestaShop, le code iframe, les liens, les QR codes et l'API REST sont inclus dans toutes les formules Visuality. L'application Shopify fonctionne avec son propre abonnement, facturé directement par Shopify en dollars US.

Des questions ? N'hésitez-pas à nous contacter par mail sur contact@visuality.fr ou par téléphone au 05 35 54 20 41 !