API

Quote3D API'sinde Uzmanlaşın: Otomatik 3D Yazıcı Teklifleri İçin Kapsamlı Bir Rehber

16.05.2026 • 132 görüntüleme • Serdar Kaan

Quote3D API Ekosistemine Giriş

Eklemeli imalatın rekabetçi ortamında, anlık ve doğru teklifler sunmak kritik bir ayırt edici faktördür. Quote3D API, 3D model yüklemeleri ile üretime hazır fiyatlandırma arasındaki boşluğu doldurmak için tasarlanmış profesyonel düzeyde bir REST arayüzüdür. Gelişmiş bir dilimleme simülasyonu ve geometrik analiz motorundan yararlanan Quote3D, geliştiricilerin dosya doğrulamasından nihai maliyet hesaplamasına kadar tüm teklif iş akışını, bir teknisyenin manuel müdahalesine gerek kalmadan otomatikleştirmesine olanak tanır.

İster özel bir e-ticaret mağazası oluşturuyor, ister mevcut bir CRM ile entegrasyon sağlıyor veya otomatik bir üretim hattı geliştiriyor olun; Quote3D API, karmaşık 3D geometrileri (STL, OBJ ve 3MF) işlemek ve bunları filament ağırlığı, baskı süresi ve toplam maliyet gibi iş metriklerine dönüştürmek için gerekli uç noktaları (endpoints) sağlar.

Kimlik Doğrulama ve Güvenlik Mimarisi

Tescilli 3D tasarımlar ve fiyatlandırma mantığıyla uğraşırken güvenlik her şeyden önemlidir. Quote3D, tüm isteklerin HTTPS üzerinden şifrelendiğinden ve kapsamlı kimlik bilgileri aracılığıyla yetkilendirildiğinden emin olmak için bir Bearer Token kimlik doğrulama şeması kullanır.

Token Türleri ve Kullanımı

Entegrasyon mimarinize bağlı olarak iki ana token türünden birini kullanacaksınız:

API Token: Sunucudan sunucuya (backend-to-backend) iletişim için kullanılan yüksek yetkili kimlik bilgileridir. Bu token'lar dosya yönetimi, teklif oluşturma ve webhook yapılandırmasına izin verir. Bunları asla ön yüz (frontend) kodunda açık etmeyin.
Widget Token: Özellikle ön yüz widget yerleştirmeleri ve istemci tarafındaki teklif oturumları için tasarlanmış kısıtlı yetkili kimlik bilgileridir.

Backend Proxy Deseni

Maksimum güvenliği sağlamak için Quote3D, Backend Proxy Deseni'ni önerir. Bu mimaride, ön yüz uygulamanız istekleri kendi sunucunuza gönderir; sunucunuz ise yetkili API Token'ı ekleyerek isteği Quote3D'ye iletir. Bu, gizli anahtarlarınızın tarayıcının ağ (network) sekmesinde görünmesini önleyerek hesabınızı yetkisiz API kullanımından korur.

Temel Teklif İş Akışı: Adım Adım Rehber

Teklif oluşturmak tek adımlı bir işlem değil, asenkron bir iş akışıdır. Karmaşık 3D modellerin dilimlenmesi hesaplama açısından yoğun bir işlem olduğundan, Quote3D sistem kararlılığını ve API yanıt verme hızını sağlamak için bu istekleri arka planda işler.

Adım 1: Dosya Yükleme ve Yönetimi

Bir teklif oluşturulmadan önce, 3D modelin Quote3D veritabanına yüklenmesi gerekir. Bunun için iki ana seçeneğiniz vardır:

Kimlik Doğrulamalı Yükleme: Bearer token'ınız ile POST /v2/file uç noktasını kullanın. Bu, backend entegrasyonları için standart yöntemdir.
Anonim Genel Yükleme: Önce, geçici ve tek kullanımlık bir yükleme kimliği oluşturmak için GET /v2/file/upload-id çağrısını yapın. Ardından, son kullanıcının kimlik doğrulaması yapmasını gerektirmeden dosyayı yüklemek için POST /v2/file/public/{upload_id} kullanın. Bu kimliğin süresi bir saat sonra dolar.

Adım 2: Teklif Talebini Başlatma

Bir file_id elde ettiğinizde, POST /v2/file/quote/{file_id} üzerinden dilimleme ve teklif sürecini tetikleyebilirsiniz. Bu uç nokta fiyatı anında döndürmez. Bunun yerine, bir job_id içeren 202 Accepted yanıtı döndürür.

İstek gövdesinde, panelinizdeki önceden yapılandırılmış bir profili kullanmak için bir printer_id veya belirli ayarları geçersiz kılmak için bir printer_config nesnesi sağlayabilirsiniz. Bunların varsayılan olarak birbirini dışladığını unutmayın; tutarlılık için printer_id sağlamak önerilen yaklaşımdır.

Adım 3: Sonuçları Alma

İşlem asenkron olduğu için sonuçları iki yöntemden biriyle almalısınız: Polling (Sorgulama) veya Webhook'lar.

Özellik | Polling (GET /v2/jobs/{job_id}) | Webhooks (quote.completed)
Uygulama | İstemci sürekli durum sorgular | Sunucu veriyi uç noktanıza gönderir
Gecikme | Sorgulama aralığına bağlıdır | Gerçeğe yakın zamanlı
Kaynak Kullanımı | Daha yüksek (çoklu HTTP istekleri) | Daha düşük (tekil olay bildirimi)
Karmaşıklık | Uygulaması basit | Genel bir dinleyici uç noktası gerektirir

Teknik Detaylar: Fiyatlandırma Mantığı ve Yapılandırma

Quote3D motoru fiyatı sadece tahmin etmez; kesin malzeme kullanımını ve süreyi belirlemek için modelin simüle edilmiş bir dilimlemesini gerçekleştirir. Nihai total_price birkaç kritik bileşenden türetilir:

Maliyet Hesaplama Bileşenleri

Malzeme Maliyeti: Seçilen malzemenin gram başına maliyeti ile çarpılan filament_weight (destek yapıları dahil) üzerinden hesaplanır.
Makine Saatlik Ücreti: estimated_time ile ilgili yazıcının operasyonel maliyetinin çarpımıdır.
Enerji Giderleri: Makinenin watt değeri ve yerel elektrik fiyatlandırması kullanılarak hesaplanır.
Ardıl İşlem (Post-Processing): Zımparalama, boyama veya boşaltma için isteğe bağlı eklemeler.
Vergi ve Kar Marjı: Nihai ticari kar marjları ve geçerli vergi oranları.

Geometrik Bütünlük ve Yazdırılabilirlik

Teklif süreci sırasında API aynı zamanda geometrik bütünlüğü de kontrol eder. Eğer bir model "manifold" değilse (yani delikler veya örtüşen yüzeyler varsa), API bunu sonuçlarda işaretler. "Model is manifold and ready for printing" sonucu, dosyanın fiziksel makinedeki gerçek dilimleme işlemi sırasında hata vermeyeceğinin garantisidir.

Uygulama En İyi Pratikleri

Üretime hazır bir entegrasyon sağlamak için şu teknik yönergelere uyun:

Arka Plan Kuyrukları Kullanın: Webhook bildirimlerini işlerken, zaman aşımı hatalarını önlemek için hemen bir 200 OK yanıtı döndürün ve teklif verilerini bir arka plan işçisinde (örneğin Redis/Sidekiq veya RabbitMQ) işleyin.
Oturum Verilerini Önbelleğe Alın: Kullanıcıların tüm teklif sürecini yeniden başlatmadan sayfayı yenileyebilmeleri için job_id ve file_id bilgilerini veritabanınızda saklayın.
Hız Limitlerini Yönetin: /v2/jobs/ uç noktasını sorgularken, hız sınırlamasına (throttling) takılmamak için üstel geri çekilme (exponential backoff) yöntemini uygulayın.
Dosya Formatlarını Doğrulayın: API STL, OBJ ve 3MF formatlarını desteklese de, kullanıcıya anında geri bildirim sağlamak için bu uzantıları ön yüzde doğrulayın.

Sıkça Sorulan Sorular (SSS)

1. Teklif uç noktası neden fiyatı anında döndürmüyor?

Bir 3D modeli dilimlemek, takım yollarını ve malzeme hacmini hesaplamak için önemli miktarda CPU ve GPU kaynağı gerektirir. API zaman aşımlarını önlemek ve kararlılığı sağlamak için Quote3D asenkron bir iş sistemi kullanır. Bir İş Kimliği (Job ID) alırsınız ve simülasyon tamamlandığında sonuçları çekebilirsiniz.

2. Paneldeki yazıcı ayarlarımı API üzerinden geçersiz kılabilir miyim?

Evet. printer_id kullanmak daha basit olsa da, belirli bir teklif için katman yüksekliği veya dolgu yüzdesi gibi belirli parametreleri geçersiz kılmak için istek gövdesinde bir printer_config nesnesi gönderebilirsiniz.

3. /v2/file/{file_id} uç noktasını kullanarak bir dosyayı silersem ne olur?

Dosya silme işlemi geri döndürülemez bir işlemdir. 3D modeli Quote3D depolamasından kaldırır ve bu dosyaya bağlı tüm teklifleri ve geçmişi otomatik olarak siler.

4. 'quote.failed' webhook olayını nasıl yönetirim?

quote.failed olayı, model manifold değilse veya yazıcının baskı hacmini aşarsa tetiklenir. Uygulamanız bu olayı yakalamalı ve kullanıcıyı modelin geometrisini veya ölçeğini kontrol etmesi için bilgilendirmelidir.

5. API token'ımı React veya Vue ön yüzüne koymak güvenli mi?

Hayır. Ön yüz kodu, sayfayı inceleyen herkes tarafından görülebilir. Her zaman bir backend proxy kullanmalı veya istemci tarafı işlemleri için kısıtlı Widget Token'ı tercih etmelisiniz.

Sonuç

Quote3D API entegrasyonu, 3D baskı işletmenizi manuel bir teklif operasyonundan ölçeklenebilir, otomatik bir güç merkezine dönüştürür. Yükle → Teklif Al → Sorgula/Webhook iş akışını takip ederek, üretim maliyetleriniz üzerinde sıkı bir kontrol sağlarken müşterilerinize anlık ve doğru fiyatlandırmalar sunabilirsiniz. Güvenli ve profesyonel bir entegrasyon için hesap ayarlarınızdan API token'ınızı oluşturarak ve backend proxy desenini uygulayarak başlayın.