Benvenuto nella Documentazione Quote3D! ⏳
Quote3D LogoQuote3DDocumentazione

Guida Rapida 🚀

Inizia subito a usare l'API di Quote3D in meno di 5 minuti! Per le integrazioni esterne, chiama gli endpoint da https://api.quote3d.com/v2. Segui questi passaggi per creare il tuo account, generare un token API e iniziare a effettuare le tue prime chiamate API.

1

Crea il Tuo Account

  1. Visita la dashboard di Quote3D per registrarti per un nuovo account
  2. Compila il modulo di registrazione con i tuoi dati
  3. Controlla la tua email e clicca sul link di conferma per attivare completamente il tuo account

Assicurati di confermare il tuo indirizzo email altrimenti il tuo account non sarà completamente attivato e non potrai accedere all'API!

2

Genera il tuo API Token

  1. Accedi al tuo account Quote3D
  2. Naviga nella dashboard - sarai reindirizzato qui automaticamente dopo l'accesso
  3. Clicca sulla scheda Tokens nella barra laterale sinistra
  4. Crea un nuovo token cliccando sul pulsante Nuovo Token
  5. Configura il tuo token
    • Assegna un nome descrittivo (ad esempio, "Il mio primo Token")
    • Imposta la scadenza in giorni (lascia vuoto per nessuna scadenza)
  6. Copia immediatamente il token generato e conservalo in un luogo sicuro

Vedrai il token solo una volta! Assicurati di copiarlo e salvarlo in una posizione sicura prima di chiudere la finestra popup.

3

Autenticati con l'API

  1. Vai al playground dell'API a /docs/playground
  2. Clicca sull'icona del lucchetto nell'angolo in alto a destra
  3. Incolla il tuo token JWT dal Passaggio 2 nel campo di autorizzazione
  4. Clicca Authorize

🎉 Congratulazioni! Ora sei autenticato e pronto a esplorare l'API di Quote3D.

4

Effettua la Tua Prima Chiamata API

Pronto a testarlo? Prova a caricare il tuo primo file STL:

  1. Individua l'endpoint POST https://api.quote3d.com/v2/file nella documentazione API
  2. Espandi la scheda per rivelare i dettagli della richiesta POST
  3. Carica un file STL utilizzando il pulsante "Scegli file" per aprire l'esploratore file
  4. Esegui la richiesta

La risposta includerà un ID file che puoi utilizzare per:

  • Verificare le dimensioni e la stampabilità
  • Generare preventivi per stime di prezzo istantanee automatizzate
  • Gestire il file caricato per risparmiare spazio di archiviazione nel cloud

L'ID file funge da chiave per gestire e fare riferimento ai tuoi file caricati nelle chiamate API successive. È l'identificatore univoco da cui dipendono tutte le altre chiamate API.

Albero decisionale degli endpoint

Utilizza questo percorso rapido per decidere quale endpoint chiamare successivamente su https://api.quote3d.com/v2.

  1. Hai bisogno di caricare dal tuo backend? Utilizza POST https://api.quote3d.com/v2/file con il tuo Bearer token.
  2. Hai bisogno di un caricamento diretto tramite browser senza esporre il tuo token? Ottieni un ID di caricamento da GET https://api.quote3d.com/v2/file/upload-id, quindi carica tramite POST https://api.quote3d.com/v2/file/public/{upload_id}.
  3. Serve una validazione di dimensioni/fitting prima della quotazione? Eseguire una chiamata POST a https://api.quote3d.com/v2/printability/{file_id}.
  4. Hai bisogno di un preventivo? Inizia con POST https://api.quote3d.com/v2/file/quote/{file_id}.
  5. In attesa del completamento del preventivo? Eseguire il polling di GET https://api.quote3d.com/v2/jobs/{job_id} fino a COMPLETED, FAILED o CANCELLED.
  6. Hai bisogno della cronologia/dei dettagli dei preventivi salvati? Utilizzare GET https://api.quote3d.com/v2/quotes e GET https://api.quote3d.com/v2/quotes/{quote_id}.

Nota: Se non vengono inviati i dettagli relativi a tecnologia, stampante o materiale nelle richieste di preventivo, l'API utilizzerà le impostazioni predefinite del profilo utente.

Errori comuni e come procedere

Azioni rapide per i casi limite più comuni.

429 Limite di frequenza raggiunto: Leggere gli header X-RateLimit-* e Retry-After, attendere e riprovare con backoff esponenziale.

Formato file non valido: Carica solo file STL, 3MF o OBJ. Esporta nuovamente il modello e verifica l'integrità del file.

Il modello non entra nel piano di stampa: Eseguire prima il controllo di stampabilità, ridurre la scala del modello o selezionare un profilo stampante o un volume di stampa più grande.

Avviso anomalia unità: Il modello probabilmente utilizza una scala in pollici/metri. Esporta nuovamente in millimetri (mm) e riprova.

Cosa c'è dopo?

Ora che sei configurato, esplora queste funzionalità chiave:

  • Gestione File - Carica, scarica e gestisci i tuoi file di modelli 3D (STL, 3MF, OBJ)
  • Verifica di Stampabilità - Verifica se i tuoi modelli si adattano alle dimensioni della tua stampante
  • Generazione Preventivo - Ottieni prezzi istantanei nella tua valuta preferita con stime dettagliate dell'utilizzo del materiale e dei tempi di stampa
  • Storico Preventivi - Accedi a tutti i tuoi preventivi passati e gestiscili
  • Webhook - Ricevi notifiche in tempo reale per il completamento dei preventivi e il caricamento dei file
  • Analisi - Monitora il tuo utilizzo, i materiali più popolari e le tendenze dei costi
  • Gestione Account - Monitora le tue quote, le statistiche di utilizzo e i dettagli dell'abbonamento

Importante: Tutti gli endpoint API richiedono l'autenticazione con il tuo API token. Assicurati di includerlo nell'header Authorization di ogni richiesta.

Esempio: Authorization: Bearer YOUR_TOKEN_HERE

Hai bisogno di aiuto? Consulta la nostra guida ai Concetti Fondamentali o esplora il Playground API per una documentazione interattiva.