Benvenuto nella Documentazione Quote3D! ⏳

Benvenuto in Quote3D!

Quote3D - Instant 3D Printing Quotes via API

Panoramica

Quote3D è una REST API e una piattaforma di widget incorporabili per l'analisi della stampa 3D, la generazione asincrona di preventivi e i workflow di produzione. Le richieste API esterne vengono gestite da https://api.quote3d.com/v2. Che tu stia sviluppando un servizio di stampa 3D, integrando la quotazione in un sito e-commerce o automatizzando la tua print farm, Quote3D ti aiuta a ottenere dati accurati su prezzi e stampabilità.

Questa documentazione fornisce tutto ciò di cui hai bisogno per integrare Quote3D nella tua applicazione. L'abbiamo progettata per essere chiara, completa e facile da seguire, sia che tu sia uno sviluppatore esperto sia che tu stia iniziando con le API.

Caratteristiche principali

  • Lavori di preventivo asincroni - Prezzi accurati, utilizzo dei materiali e stime dei tempi di stampa (FDM, SLA, SLS) tramite elaborazione basata su lavori
  • Supporto Multi-Formato – Analisi geometrica professionale per file STL, 3MF e OBJ
  • Stampabilità e sicurezza - Valutazione pre-stampa del rischio di adesione al piano, integrità geometrica (bordi aperti/errori non manifold) e verifica dei limiti
  • Metriche tecniche avanzate - Dati di produzione dettagliati tra cui area superficiale, volume dei supporti e analisi non manifold
  • Cronologia dei Preventivi Aziendali – Gestione e recupero centralizzati di tutti i tuoi preventivi professionali
  • Webhook Avanzati – Integrazione in tempo reale con i tuoi flussi di lavoro aziendali esistenti (ERP/CRM)
  • Analisi Approfondite – Monitoraggio dettagliato del consumo di materiali, delle tendenze dei costi e dell'efficienza della produzione
  • Widget incorporabili - Flussi di quotazione lato client con postMessage, supporto per reindirizzamenti e integrazioni plugin

Come funziona

  1. Carica il tuo file modello 3D (formato STL, 3MF o OBJ)
  2. Configura le impostazioni della stampante e i parametri di prezzo (o utilizza i valori predefiniti)
  3. Richiedi un preventivo - Quote3D analizza il tuo modello e calcola i prezzi
  4. Interroga l'endpoint del job o utilizza i webhook per ottenere informazioni sull'utilizzo dei materiali, sul tempo di stampa e sul costo totale
  5. Accedi alla cronologia dei preventivi, alle analisi e gestisci i tuoi file tramite l'API

Se la documentazione non copre ciò che stai cercando, o se qualcosa non ti è chiaro, visita il nostro repository GitHub e apri un issue o una PR: questa documentazione è in corso di sviluppo e accogliamo tutti i contributi!

Stiamo sviluppando e migliorando attivamente il servizio, quindi aspettati modifiche e nuove funzionalità frequentemente, nonché aggiornamenti a questa documentazione.

Architettura del sistema e motore principale

Al centro di Quote3D si trova un avanzato motore di simulazione dello slicing 3D e di analisi geometrica. A differenza dei semplici calcolatori basati sul volume, il nostro sistema interpreta realmente la geometria dei modelli caricati per fornire preventivi altamente accurati di livello industriale.

Supporto Multi-Tecnologia

Il nostro motore adatta dinamicamente la sua logica di calcolo a tre distinte tecnologie di produzione:

  • FDM (Fused Deposition Modeling): Calcoliamo le lunghezze del percorso del filamento, la generazione di gusci layer-by-layer, le geometrie di riempimento (infill) e le necessarie strutture di supporto. I parametri della macchina come la dimensione dell'ugello, varie velocità (stampa, movimento, retrazione) e i limiti di jerk/accelerazione sono presi in considerazione con precisione per stimare il tempo di stampa reale.
  • SLA (Stereolitografia): Il calcolo passa a metriche di esposizione alla luce. Il tempo di stampa è derivato dal numero di layer, dai tempi di esposizione standard, dalle sovrascritture dell'esposizione del layer di base e dai movimenti meccanici di sollevamento/retrazione del serbatoio di resina.
  • SLS (Selective Laser Sintering): I calcoli utilizzano la velocità del laser, la spaziatura dell'hatch, i tempi di ricopertura del layer e i tempi di preriscaldamento/raffreddamento. SLS consente l'impilamento 3D di parti all'interno del letto di polvere, un fattore che il nostro motore di batching supporta nativamente.

Packing e Batching 3D Avanzati

Quando un preventivo richiede più quantità, il nostro algoritmo avanzato di bin-packing 3D calcola esattamente quante parti possono entrare in un singolo ciclo di produzione (batch) in base al volume di costruzione della macchina (X, Y, Z). Raggruppando le parti in batch, le operazioni generali—come il preriscaldamento del letto o la ricopertura dei layer SLS—sono ammortizzate per batch piuttosto che per parte. Questo fornisce una scalabilità incredibilmente conveniente per la produzione di volumi.

Calcolo Completo dei Costi

Il prezzo non è semplicemente un ricarico sul peso del materiale. Quote3D formula il prezzo finale sommando:

  • Costo del Materiale: Derivato dai grammi esatti di materiale utilizzato (incluse le strutture di supporto generate) moltiplicati per il costo per grammo del tuo materiale.
  • Tariffa Oraria della Macchina: Il tempo di stampa simulato è moltiplicato per il costo operativo orario specifico della macchina assegnata.
  • Costi Energetici: Considerando i costi energetici locali (kWh) rispetto alla potenza della macchina (watt).
  • Post-Elaborazione e Margini: Commissioni fisse, opzioni di post-elaborazione (levigatura, verniciatura, svuotamento) e aliquote fiscali vengono applicate come livelli finali nella valuta selezionata.

Integrazione API e Dashboard Senza Soluzione di Continuità

L'intero motore è incapsulato dietro una elegante REST API e un Dashboard intuitivo. Puoi definire i tuoi Profili Stampante predefiniti, i Profili Materiale e le Configurazioni Preventivo nel dashboard visivamente. Quando arrivano le richieste API, ereditano automaticamente queste impostazioni a meno che non vengano esplicitamente sovrascritte dal payload della richiesta, consentendo una flessibilità assoluta per i casi limite mantenendo le tue chiamate API pulite e minime.

Vuoi iniziare subito? 🚀

Consulta l'indice della documentazione per iniziare con l'autenticazione, i concetti fondamentali, i caricamenti, le quotazioni asincrone, i widget e i webhook.