Quote3D Dokümantasyonuna Hoş Geldiniz! ⏳

Quote3D'e Hoş Geldiniz!

Quote3D - Instant 3D Printing Quotes via API

Genel Bakış

Quote3D; 3D baskı analizi, asenkron teklif oluşturma ve üretim iş akışları için bir REST API ve gömülebilir widget platformudur. Harici API istekleri https://api.quote3d.com/v2 üzerinden sunulur. İster bir 3D baskı hizmeti kuruyor, ister bir e-ticaret sitesine teklif verme özelliğini entegre ediyor, ister baskı çiftliğinizi otomatikleştiriyor olun; Quote3D, doğru fiyatlandırma ve basılabilirlik verileri almanıza yardımcı olur.

Bu dokümantasyon, Quote3D'ı uygulamanıza entegre etmek için ihtiyacınız olan her şeyi sağlar. Deneyimli bir geliştirici olsanız da, API'lerle yeni başlıyor olsanız da, net, kapsamlı ve takip etmesi kolay olacak şekilde tasarladık.

Temel Özellikler

  • Async Quote Job'ları - İş tabanlı akışla doğru fiyatlandırma, malzeme kullanımı ve baskı süresi tahminleri (FDM, SLA, SLS)
  • Çoklu Format Desteği - STL, 3MF ve OBJ dosyaları için profesyonel geometri analizi
  • Yazdırılabilirlik ve Güvenlik - Baskı öncesi yatak yapışma riski değerlendirmesi, geometrik bütünlük (açık kenarlar/çoklu yüzey hataları) ve sınır doğrulaması
  • Gelişmiş Teknik Metrikler - Yüzey alanı, destek hacmi ve çoklu yüzey analizi gibi detaylı üretim verileri
  • Fiyat Teklifi Geçmişi - Tüm kurumsal tekliflerinizi merkezi olarak yönetin
  • Gelişmiş Webhook'lar - ERP, CRM, sepet ve arka plan iş akışları ile gerçek zamanlı entegrasyon
  • Detaylı Analitik - Malzeme tüketimi, maliyet trendleri ve üretim verimliliği takibi
  • Gömülebilir Widget'lar - postMessage, redirect desteği ve plugin entegrasyonlarıyla istemci tarafı teklif akışları

Nasıl Çalışır

  1. 3D model dosyanızı yükleyin (STL, 3MF veya OBJ formatı)
  2. Yazıcı ayarlarınızı ve fiyatlandırma parametrelerinizi yapılandırın (veya varsayılanları kullanın)
  3. Bir fiyat teklifi işi oluşturun - Quote3D model için eşzamansız analiz ve fiyatlandırma başlatır
  4. İş uç noktasını yoklayın veya malzeme kullanımı, baskı süresi ve toplam maliyeti almak için webhook'ları kullanın
  5. API üzerinden fiyat teklifi geçmişine, analitiklere erişin ve dosyalarınızı yönetin

Dokümantasyon aradığınızı kapsamıyorsa veya bir şey belirsiz görünüyorsa, lütfen GitHub repo'muzu ziyaret edin ve bir issue veya PR açın - bu dokümantasyon devam eden bir çalışmadır ve tüm katkıları memnuniyetle karşılıyoruz!

Hizmeti aktif olarak geliştiriyor ve iyileştiriyoruz, bu nedenle bu dokümantasyondaki güncellemelerin yanı sıra sık sık değişiklikler ve yeni özellikler bekleyin.

Sistem Mimarisi ve Çekirdek Motor

Quote3D'nin kalbinde gelişmiş bir 3D dilimleme simülasyonu ve geometrik analiz motoru bulunur. Basit hacim tabanlı hesaplayıcıların aksine, sistemimiz yüklenen modellerin geometrisini gerçek anlamda yorumlayarak endüstriyel düzeyde doğru fiyatlandırma sunar.

Çoklu Teknoloji Desteği

Motorumuz, hesaplama mantığını üç farklı üretim teknolojisine dinamik olarak uyarlar:

  • FDM (Fused Deposition Modeling): Filament yol uzunluklarını, katman katman kabuk (düvar) oluşumunu, dolgu geometrilerini ve gerekli destek yapılarını hesaplıyoruz. Cihazın nozul boyutu, hız değerleri ve ivmelenme limitleri baskı süresini tahmin etmek için hassas bir şekilde dikkate alınır.
  • SLA (Stereolithography): Hesaplama, ışık maruz kalma metriklerine geçer. Baskı süresi, katman sayısı, standart maruz kalma süreleri, taban katmanı maruz kalma ayarları ve reçine haznesinin mekanik kaldırma/çekme hareketlerinden türetilir.
  • SLS (Selective Laser Sintering): Lazer hızı, satır aralığı, katman recoat (toz serme) süreleri ve ısıtma/soğutma süreleri kullanılır. SLS, parçaların toz yatağı içinde 3D olarak (üst üste) konumlandırılmasına olanak tanır ve yerleştirme motorumuz bunu yerel olarak destekler.

Gelişmiş 3D Yerleştirme (Bin-Packing) ve Toplu Üretim

Bir fiyat teklifinde birden fazla adet istendiğinde, gelişmiş 3D yerleştirme algoritmamız makinenin baskı hacmine (X, Y, Z) göre tek bir üretim işlemine (batch) tam olarak kaç parçanın sığabileceğini hesaplar. Parçaları batch'ler halinde gruplandırarak, ısıtma veya katman değişimi gibi sabit süre/maliyet operasyonları parça başına değil, sadece gerekli olan batch başına hesaplanır. Bu, hacimli (çoklu) üretimlerde inanılmaz derecede uygun maliyetli ölçeklendirme sağlar.

Kapsamlı Maliyet Hesaplama

Fiyatlandırma sadece malzeme ağırlığı üzerinden bir kâr marjı demek değildir. Quote3D nihai fiyatı şu değişkenleri toplayarak formüle eder:

  • Malzeme Maliyeti: Kullanılan malzemenin (üretilen destekler dahil) tam gramajının, malzemenizin gram başına maliyeti ile çarpılmasıyla elde edilir.
  • Makine Saatlik Ücreti: Simüle edilen baskı süresi, atanan makinenin özel saatlik operasyonel maliyeti ile çarpılır.
  • Enerji Gideri: Yerel enerji maliyetleri (kWh) makine gücüyle ilişkilendirilerek hesaba katılır.
  • Son İşlemler ve Kâr Marjları: Sabit ücretler, son işlem seçenekleri (zımparalama, boyama, içi boşaltma) ve vergi oranları, seçtiğiniz para birimi cinsinden son katmanlar olarak uygulanır.

Kusursuz API ve Dashboard Entegrasyonu

Tüm bu motor, şık bir REST API ve kullanıcı dostu bir Dashboard arkasında kapsüllenmiştir. Varsayılan Yazıcı Profillerinizi, Malzeme Profillerinizi ve Fiyat Teklifi Ayarlarınızı kontrol panelinden görsel olarak tanımlayabilirsiniz. API istekleri geldiğinde, istek gövdesinde (payload) açıkça geçersiz kılınmadıkça (override) bu ayarları otomatik olarak devralır. Bu durum API çağrılarınızı temiz ve esnek tutar.

Hemen başlamak ister misiniz? 🚀

Kimlik doğrulama, temel kavramlar, upload, async quote, widget ve webhook bölümlerinden başlamak için doküman indeksine göz atın.