Quote3D Nedir? API ve Widget Genel Bakışı
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
- Asenkron teklif işleri - iş tabanlı işleme ile doğru fiyat, malzeme kullanımı ve baskı süresi tahmini (FDM, SLA, SLS, SLM, MJF)
- Çoklu Format Desteği - STL, 3MF, OBJ ve STEP 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
- 3D model dosyanızı yükleyin: STL, 3MF, OBJ veya STEP (.step/.stp)
- Yazıcı ayarlarınızı ve fiyatlandırma parametrelerinizi yapılandırın (veya varsayılanları kullanın)
- Bir fiyat teklifi işi oluşturun - Quote3D model için eşzamansız analiz ve fiyatlandırma başlatır
- İş uç noktasını yoklayın veya malzeme kullanımı, baskı süresi ve toplam maliyeti almak için webhook'ları kullanın
- 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ı beş ayrı üretim teknolojisine göre dinamik olarak uyarlar:
- FDM (Fused Deposition Modeling): Filament yol uzunluklarını, katman katman kabuk (duvar) oluşumunu, dolgu geometrilerini ve gerekli destek yapılarını hesaplıyoruz. Nozul çapı, çeşitli hızlar (baskı, boş hareket, geri çekme) ve jerk/ivme limitleri gibi makine parametreleri, gerçek baskı süresini tahmin etmek için hassas biçimde hesaba katılı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ı, tarama aralığı, katman 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.
- SLM (Seçici Lazer Eritme, ayrıca DMLS veya LPBF olarak da adlandırılır): metal toz yatağı işlemidir. Tarama süresi, yayınlanan üretim hızları bunu hariç tuttuğu için, üzerine yeniden kaplama (recoating) eklenmiş haliyle tedarikçinin üretim hızı formülünü — katman kalınlığı x tarama hızı x tarama arası mesafe x lazer sayısı — takip eder. SLM’yi polimer toz işlemlerinden ayıran iki şey vardır: destekler zorunludur ve yük taşıyıcıdır; ayrıca parçalar Z ekseninde üst üste istiflenemez, bu nedenle yerleştirme (nesting) baskı tablası üzerinde iki boyutludur. Kullanılmayan metal tozu elenir ve yeniden kullanılır, bu nedenle çevreleyen toz asla faturalandırılmaz, sadece eleme kaybı faturalandırılır.
- MJF (HP Multi Jet Fusion): lazer içermeyen bir toz yatağı işlemidir. Taşıyıcı kafa tozu serer, füzyon ve detaylandırma ajanlarını püskürtür ve bir kızılötesi lamba tüm yatağı tek bir geçişte eritir; böylece üretim süresi XY geometrisinden bağımsızdır ve HP’nin yayınladığı üretim hızının belirttiği gibi katman başına sabittir. Toz hesaplaması SLS ile aynıdır (kek, yenileme oranı, hapsolmuş toz, Z istifleme) ve ek maliyet kalemi olarak sadece ajan tüketimi eklenir.
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.
- Asgari Teklif Tutarı: teknoloji başına isteğe bağlı bir taban. Vergi öncesi bu tutarın altında çıkan teklif bu tutara yükseltilir; sabit ücretten farklı olarak daha büyük teklifleri değiştirmez.
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.