Guide de dĂ©marrage rapide đ
Commencez à utiliser l'API Quote3D en moins de 5 minutes ! Pour les intégrations externes, appelez les points de terminaison depuis https://api.quote3d.com/v2. Suivez ces étapes pour créer votre compte, générer un jeton API et commencer à effectuer vos premiers appels API.
Créez votre compte
- Visitez le tableau de bord Quote3D pour vous inscrire Ă un nouveau compte
- Remplissez le formulaire d'inscription avec vos informations
- Vérifiez votre boßte de réception et cliquez sur le lien de confirmation pour activer complÚtement votre compte
Assurez-vous de confirmer votre adresse e-mail, sinon votre compte ne sera pas entiÚrement activé et vous ne pourrez pas accéder à l'API !
Générez votre jeton API
- Connectez-vous Ă votre compte Quote3D
- Accédez au tableau de bord - vous serez automatiquement redirigé ici aprÚs la connexion
- Cliquez sur l'onglet "Tokens" dans la barre latérale gauche
- Créez un nouveau jeton en cliquant sur le bouton "Nouveau jeton"
- Configurez votre jeton
- Donnez-lui un nom descriptif (par exemple, « Mon premier jeton »)
- Définissez la date d'expiration en jours (laissez ce champ vide pour une durée illimitée)
- Copiez immédiatement le jeton généré et conservez-le en lieu sûr
Vous ne verrez le jeton qu'une seule fois ! Assurez-vous de le copier et de l'enregistrer dans un endroit sĂ»r avant de fermer la fenĂȘtre contextuelle.
Authentifiez-vous avec l'API
- Naviguez vers le terrain de jeu de l'API Ă l'adresse /docs/playground
- Cliquez sur l'icĂŽne de cadenas en haut Ă droite
- Collez votre jeton JWT de l'Ă©tape 2 dans le champ d'autorisation
- Cliquez
Authorize
đ FĂ©licitations ! Vous ĂȘtes maintenant authentifiĂ© et prĂȘt Ă explorer l'API Quote3D.
Faites votre premier appel API
PrĂȘt Ă tester ? Essayez de tĂ©lĂ©charger votre premier fichier STL :
- Trouvez le point de terminaison POST https://api.quote3d.com/v2/file dans la documentation de l'API
- DĂ©veloppez l'onglet pour afficher les dĂ©tails de la requĂȘte POST
- Téléchargez un fichier STL à l'aide du bouton « Choisir un fichier » pour ouvrir votre explorateur de fichiers
- ExĂ©cutez la requĂȘte
La réponse inclura un ID de fichier que vous pourrez utiliser pour :
- Vérification des dimensions et de l'imprimabilité
- Génération de devis pour des estimations de prix instantanées automatisées
- Gestion du fichier téléchargé pour l'enregistrer dans votre stockage cloud
L'ID de fichier (file_id) sert de clĂ© pour gĂ©rer et rĂ©fĂ©rencer vos fichiers tĂ©lĂ©chargĂ©s dans les appels API suivants. Il s'agit de l'identifiant unique Ă partir duquel toutes les autres requĂȘtes API sont initiĂ©es.
Arbre de décision des points de terminaison
Utilisez ce chemin rapide pour décider quel endpoint appeler ensuite sur https://api.quote3d.com/v2.
- Besoin d'effectuer un téléversement depuis votre backend ? Utilisez POST https://api.quote3d.com/v2/file avec votre jeton Bearer.
- Besoin d'un upload direct via le navigateur sans exposer votre token ? Récupérez un ID de téléversement via GET https://api.quote3d.com/v2/file/upload-id, puis effectuez le téléversement avec POST https://api.quote3d.com/v2/file/public/{upload_id}.
- Besoin d'une validation de la taille/ajustement avant la tarification ? Appeler POST https://api.quote3d.com/v2/printability/{file_id}.
- Besoin d'un devis ? Commencez par POST https://api.quote3d.com/v2/file/quote/{file_id}.
- Attente de la finalisation du devis ? Effectuer un polling GET sur https://api.quote3d.com/v2/jobs/{job_id} jusqu'Ă l'Ă©tat COMPLETED, FAILED ou CANCELLED.
- Besoin de l'historique ou des détails des devis enregistrés ? Utilisez GET https://api.quote3d.com/v2/quotes et GET https://api.quote3d.com/v2/quotes/{quote_id}.
Note : Si vous n'envoyez pas les détails relatifs à la technologie, à l'imprimante ou au matériau dans les demandes de devis, l'API utilise par défaut les paramÚtres de votre profil utilisateur.
Erreurs courantes et marche Ă suivre
Actions rapides pour les cas limites les plus fréquents.
429 Limite de dĂ©bit atteinte : Lisez les en-tĂȘtes X-RateLimit-* et Retry-After, attendez, puis rĂ©essayez avec un backoff exponentiel.
Format de fichier invalide : Importez uniquement des fichiers STL, 3MF ou OBJ. Réexportez le modÚle et vérifiez l'intégrité du fichier.
Le modÚle ne tient pas sur le plateau : Lancez d'abord la vérification de l'imprimabilité, réduisez l'échelle du modÚle ou sélectionnez un profil d'imprimante ou un volume d'impression plus grand.
Avertissement : anomalie d'unité Votre modÚle utilise probablement une échelle en pouces/mÚtres. Réexportez en millimÚtres (mm) et réessayez.
Que faire ensuite ?
Maintenant que vous ĂȘtes configurĂ©, explorez ces fonctionnalitĂ©s clĂ©s :
- Gestion des fichiers - Téléchargez, téléchargez et gérez vos fichiers de modÚles 3D (STL, 3MF, OBJ)
- Vérification d'imprimabilité - Vérifiez si vos modÚles correspondent aux dimensions de votre imprimante
- Génération de devis - Obtenez des prix instantanés dans votre devise préférée avec des estimations détaillées de l'utilisation des matériaux et du temps d'impression
- Historique des devis - Accédez à tous vos devis passés et gérez-les
- Webhooks - Recevez des notifications en temps réel pour les devis terminés et les téléchargements de fichiers
- Analytique - Suivez votre utilisation, les matériaux populaires et les tendances des coûts
- Gestion du compte - Surveillez vos quotas, vos statistiques d'utilisation et les détails de votre abonnement
Important : Tous les points de terminaison de l'API nĂ©cessitent une authentification avec votre token Bearer. Assurez-vous de l'inclure dans l'en-tĂȘte Authorization de chaque requĂȘte.
Exemple : Authorization: Bearer YOUR_TOKEN_HERE
Besoin d'aide ? Consultez notre guide des Concepts de base ou explorez le Playground de l'API pour une documentation interactive.