Charger un fichier 3D dans le Cloud Engine Sculpteo

La première étape à considérer pour offrir un service d'impression 3D en ligne à vos clients est de récupérer les fichiers 3D qui vont être imprimés. D'une manière générale, ceux-ci proviennent soit de votre site internet ou soit de la boutique de Sculpteo.

Vous trouverez dans cette page différentes informations en fonction de la provenance de vos fichiers 3D :


Le diagramme suivant résume de façon plus détaillée les possibilités :




Informations générales sur les fichiers 3D hebergés par Sculpteo

Formats de fichiers 3D acceptés par Sculpteo

Le Cloud Engine de Sculpteo est compatible avec pratiquement tous les formats de fichiers 3D. Vous trouverez sur la page dédiée la liste exacte des formats supportés, avec pour chacun d'entre eux les fonctionnalités associées.

Réparation automatique des modèles 3D

Tous les fichiers 3D chargés sur notre site sont soumis automatiquement à nos algorithmes de réparation des modèles 3D. Le but de cette réparation est de passer d'un modèle virtuel à un objet solide en corrigeant les nombreuses incohérences géométriques liées à l'utilisation de logiciels de modélisation focalisés sur le rendu visuel plutôt que l'impression 3D.

Grâce à cet outil en ligne, la très grande majorité des fichiers 3D chargés sur notre site sont rendus automatiquement imprimables sur nos imprimantes 3D professionnelles, sans que ni vous ni l'utilisateur n'ayez la moindre action à effectuer !

Vous trouverez plus d'informations à ce sujet sur la page réparation des fichiers 3D.

Identifier un design 3D : l'UUID

L'UUID (Universal Unique IDentifier) d'un design 3D chargé sur le site de Sculpteo est l'identifiant unique qui permet de le repérer et d'agir dessus. Les fichiers 3D nouvellement chargés, les modèles 3D déjà présents dans notre boutique ou encore ceux issus de la personnalisation de designs existants, tous possèdent un UUID qui va ensuite permettre de les afficher, de les configurer et de les imprimer en 3D.

Si vous vous intéressez à un modèle 3D présent sur le site de Sculpteo en particulier, il vous suffit de repérer son UUID pour pouvoir vous en servir dans les phases suivantes.

Comment trouver l'UUID d'un design ? Rendez-vous sur la page produit du modèle 3D et étudiez le lien de la page. L'UUID est le mot de 8 lettres situé entre le nom du design et le point d'interrogation, comme sur l'exemple suivant :
//www.sculpteo.com/fr/print/coque-citrouille-iphone-5-159/PpAK2tcc?uuid=Ni49MqVeYrHIo1BxrYFU2e.

Récupérer un fichier 3D provenant de Sculpteo

La solution la plus simple pour proposer le service d'impression 3D de Sculpteo à vos clients est de commencer avec les modèles 3D présents sur notre site. Puisque ni vous ni l'utilisateur n'avez besoin de modéliser des designs 3D, cette option est souvent intéressante dans un premier temps, à condition de sélectionner des modèles 3D pertinents pour ses clients.

Tout ce que vous avez à faire est de parcourir la boutique en ligne de Sculpteo, de sélectionner les modèles 3D qui vous intéressent et de récupérer leur UUID, comme expliqué dans la section précédente. Avec cet identifiant, vous serez ensuite en mesure d'obtenir toutes les informations qui vous intéressent pour afficher le modèle 3D par vos propres moyens ou tout simplement afficher la fenêtre produit du design 3D sur votre site.

Charger un fichier 3D provenant de votre site internet

Si vous chargez les fichiers 3D de vos clients sur votre serveur ou si vous possédez des outils en ligne pour modéliser et personnaliser des designs 3D, alors cette partie vous concerne. Il vous faudra en effet charger les modèles finaux obtenus sur notre site afin de les afficher, de les commander ou tout simplement d'obtenir leur prix de fabrication.

Charger les fichiers manuellement sur le site de Sculpteo

Si vous souhaitez proposer à vos clients quelques fichiers 3D qui ne sont pas encore présents sur le site de Sculpteo, la solution la plus simple est de les charger manuellement sur notre site pour ensuite récupérer leurs UUID nouvellement créés et se référer à la section précédente. Si cette option s'avère rapide et facile à mettre en place, elle peut évidemment présenter quelques limites quand le nombre de fichiers 3D à charger devient trop important.

Rediriger l'utilisateur vers le site de Sculpteo grâce à l'API Web2web

Une seconde possibilité pour accéder à notre service d'impression 3D est de transférer le fichier 3D automatiquement sur notre site internet et de rediriger ensuite le client vers la page produit nouvellement créée. Ce double résultat peut être obtenu en un seul temps via l'API Web2web.

En procédant ainsi, l'utilisateur sera en mesure de visualiser le modèle 3D et de le commander directement sur notre site. Les paramètres suivants sont obligatoires et viennent s'ajouter aux paramètres facultatifs que vous trouverez dans la documentation technique :

Paramètres obligatoires Description Valeurs possibles
version Numéro de version du fichier 3D int
name Nom du design 3D string
urlfile1 URL du fichier 3D string
provider Nom du compte "provider" (contactez-nous pour le créer) string
hash Le hash de tous les paramètres et du "secret" selon l'algorithme SHA-1, tel que précisé dans la documentation string

Consultez la documentation technique de l'API Web2web pour plus d'informations.

Notez qu'il est possible d'obtenir le même résultat en effectuant une redirection après utilisation de l'API Direct Upload décrite dans la section qui suit.

Charger le fichier 3D en arrière-plan grâce à l'API Direct Upload

La dernière possibilité pour uploader vos fichiers 3D sur notre serveur permet cette fois de conserver la totalité du processus sur votre site, grâce à l'API Direct Upload. Le chargement du fichier 3D est executé en arrière-plan de façon automatique, ce qui vous permet de garder vos clients sur votre site internet et de leur offrir un service d'impression 3D en complète marque blanche.

Seuls deux paramètres sont obligatoires ici, mais d'autres peuvent éventuellement venir définir plus précisément les options et caractéristiques du design 3D uploadé.

Paramètres obligatoires Description Valeurs possibles
file Fichier 3D à charger multipart POST data
name Nom du design 3D string

Consultez la documentation technique de l'API Direct Upload pour plus d'informations.



ETAPE SUIVANTE

Documentation technique

Développeur confirmé ?
Parcourez la documentation technique de nos APIs

×