Bienvenue dans la documentation Quote3D ! ⏳
Quote3D LogoQuote3DDocumentation

Démarrage rapide de l'API de devis 3D

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.

1

Créez votre compte

  1. Visitez le tableau de bord Quote3D pour vous inscrire à un nouveau compte
  2. Remplissez le formulaire d'inscription avec vos informations
  3. 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 !

2

Générez votre jeton API

  1. Connectez-vous à votre compte Quote3D
  2. Accédez au tableau de bord - vous serez automatiquement redirigé ici après la connexion
  3. Cliquez sur l'onglet "Tokens" dans la barre latérale gauche
  4. Créez un nouveau jeton en cliquant sur le bouton "Nouveau jeton"
  5. 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)
  6. 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.

3

Authentifiez-vous avec l'API

  1. Naviguez vers le terrain de jeu de l'API à l'adresse /docs/playground
  2. Cliquez sur l'icône de cadenas en haut à droite
  3. Collez votre jeton JWT de l'étape 2 dans le champ d'autorisation
  4. Cliquez Authorize

Félicitations ! Vous êtes maintenant authentifié et prêt à explorer l'API Quote3D.

4

Faites votre premier appel API

Prêt à tester ? Essayez de télécharger votre premier fichier STL :

  1. Trouvez le point de terminaison POST https://api.quote3d.com/v2/file dans la documentation de l'API
  2. Développez l'onglet pour afficher les détails de la requête POST
  3. Téléchargez un fichier STL à l'aide du bouton « Choisir un fichier » pour ouvrir votre explorateur de fichiers
  4. 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.

  1. Besoin d'effectuer un téléversement depuis votre backend ? Utilisez POST https://api.quote3d.com/v2/file avec votre jeton Bearer.
  2. 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}.
  3. Besoin d'une validation de la taille/ajustement avant la tarification ? Appeler POST https://api.quote3d.com/v2/printability/{file_id}.
  4. Besoin d'un devis ? Commencez par POST https://api.quote3d.com/v2/file/quote/{file_id}.
  5. Attente de la finalisation du devis ? Interrogez GET https://api.quote3d.com/v2/jobs/{job_id} jusqu'à ce que le statut soit completed, failed ou cancelled. Les valeurs de statut sont en minuscules, et un travail en échec répond tout de même HTTP 200.
  6. 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

Où aller ensuite

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.