Sitenize 3D Baskı Teklif Widget'ı Yerleştirin

Genel Bakış

Quote3D Gömülebilir Widget'ı, herhangi bir web sitesinde müşterilerinize anında 3D baskı fiyat teklifleri sunmanıza olanak tanıyan kodsuz/az kodlu bir çözümdür. İster özel bir site, ister WordPress veya Shopify kullanın, 3D model görüntüleme ile sipariş verme arasındaki boşluğu sorunsuz bir şekilde kapatabilirsiniz.

Temel Özellikler

• 3D Model Görüntüleyici: Yüklenen STL, OBJ, 3MF ve STEP dosyalarının etkileşimli önizlemesi.
• Anında Fiyatlandırma: Kendi malzeme ve yazıcı profillerinize dayalı otomatik maliyet hesaplaması.
• Çoklu teknoloji: FDM, SLA, SLS, SLM ve MJF desteklenir; her biri kendi hesaplama mantığına sahiptir.
• Özel Temalar: Glassmorphism ve özel renk paletleri ile marka estetiğinize uyum sağlayın.
• Müşteriler İçin Sıfır Yapılandırma: Müşterilerinizin teknik dilimleme detaylarını bilmesine gerek yoktur; her şey Quote3D tarafından halledilir.
• Platform Eklentileri: WooCommerce, PrestaShop, OpenCart, Magento ve Wix için kurulabilir paketler; Shopify, Webflow ve Framer için hazır kodlar.
• Basit ve Gelişmiş formlar: Dilimleyici ayarları yerine yalnız baskı kalitesini ve dayanımı sorun, tüm baskı ayarlarını gösterin ya da her müşterinin ikisi arasında geçiş yapmasına izin verin. Widget özelleştiricisinden ya da SDK'nın mode seçeneğiyle ayarlanır.

Neler Yapabilirsiniz?

• Gerçek Zamanlı E-Ticaret Senkronizasyonu: Fiyat tekliflerini doğrudan mağazanızın sepetine bağlamak için 'Sepete Ekle' olaylarını kullanın.
• Otomatik Potansiyel Müşteri Oluşturma: Müşteri gereksinimlerini ve model verilerini otomatik olarak yakalayın.
• Küçük Resim Oluşturma: Üretim takibi için model ekran görüntülerini otomatik olarak yakalayın ve saklayın.
• Esnek Yönlendirmeler: Başarılı bir hesaplamadan sonra müşterileri belirli bir açılış sayfasına gönderin. Yönlendirme hedefi bir http veya https URL'si olmalıdır.

Platform Entegrasyonları: WooCommerce, Shopify, PrestaShop, OpenCart, Magento ve Diğerleri

Widget her web sitesinde çalışır. Bu platformlar için kurulabilir paketler veya hazır kodlar sunuyoruz; sepette ne olacağı platforma göre değişir:

• WooCommerce için Quote3D
• PrestaShop için Quote3D
• OpenCart için Quote3D
• Magento için Quote3D
• Wix için Quote3D
• Shopify için Quote3D

Diğer platformlar ve özel yapılar

• Wix: teklif fiyatını sitenizin arka ucunda doğrulayıp Wix Stores sepetine ekleyen bir Velo paketi (Premium plan; şu an beta olan Wix eCommerce Catalog service plugin'i kullanır). Sepet satırında modelin küçük resmi değil, taşıyıcı ürünün görseli görünür: Wix yalnızca kendi Media Manager'ındaki görselleri kabul eder.
• Squarespace: widget'ı bir Code Block ile gömün. Squarespace'in sepet API'si olmadığı için siparişler teklif talebi, fatura veya ödeme bağlantısıyla alınır.
• PrestaShop 8: teklif fiyatını sunucunuzda doğrulayıp sepete ekleyen kurulabilir bir modül; Quote3D yönetim paneli Sell menüsünde: teklifler, üretim kuyruğu, renk stoğu, raporlar, model indirme ve ayarlar.
• OpenCart 3.0, 4.0.2.2+ ve 4.1: teklif fiyatını sunucunuzda doğrulayıp sepete ekleyen kurulabilir bir eklenti; yönetim panelinde Quote3D menüsü: teklifler, üretim kuyruğu, renk stoğu, raporlar, model indirme ve ayarlar.
• Magento Open Source / Adobe Commerce 2.4: teklif fiyatını sunucunuzda doğrulayıp sepete ekleyen bir modül; yönetim panelinde Quote3D menüsü: teklifler, üretim kuyruğu, renk stoğu, raporlar, model indirme ve ayarlar.
• Webflow: widget'ı bir Code Embed öğesiyle gömün. Teklifler Webflow Ecommerce sepetine eklenemez.
• Framer: widget için bir React kod bileşeni. Framer'ın yerleşik sepeti yok.
• Özel Yazılımlar: Her türlü React, Vue veya Vanilla JS projesine JS SDK ile entegre edilebilir.

Teknik Çalışma Prensibi

Quote3D Widget, yüksek performanslı bir Iframe veya modern bir JS SDK olarak çalışır. İşte nasıl çalıştığı:

• İzole Çalışma: Widget, kendi korumalı alanında (Iframe) çalışır, böylece web sitenizin stilini bozmaz.
• Gerçek Zamanlı İletişim: Widget, hesaplama sonuçlarını sayfanıza 'postMessage' API'si üzerinden iletir. SDK'yı kullandığınızda olaylar herhangi bir dinleyiciye yayınlanmak yerine yalnızca widget'ı gömen kaynağa teslim edilir.
• Otomatik Boyutlandırma: SDK kullanıldığında, widget içeriğe göre yüksekliğini otomatik olarak ayarlar.

Widget'ın yanı sıra API ile çalışmak

Widget kendi API trafiğini dahili olarak yönetir — o rotaları siz çağırmazsınız. Aynı veriyi kendi kodunuzdan okumak veya üzerinde işlem yapmak istediğinizde, Temel Kavramlar'da açıklanan genel v2 uç noktalarını, bir token kimliği değil gerçek bir API Bearer token'ı ile https://api.quote3d.com/v2 üzerinde kullanın. Bir alışverişçinin yapılandırılmış bir parçayı sepetine eklemesine tepki vermek için doğrudan bir şey çağırmak yerine widget.added_to_cart webhook'una abone olun.

Güvenlik ve Doğrulama

Widget, Quote3D'yi tarayıcıdan çağırır, bu yüzden token'ı sayfa kaynağını görüntüleyen herkese görünür. Özel bir widget token'ı oluşturun, widget kapsamıyla sınırlandırın ve mağaza kaynaklarınıza bağlayın. Döndürme her iki kısıtlamayı da korur, dolayısıyla döndürülmüş bir widget token'ı asla tam erişimli hale gelmez.

Yüklenen dosyalar ve önizlemeler

Widget aracılığıyla yüklenen dosyalar şifrelenmiş olarak saklanır ve herkese açık olarak erişilemez. Sepete ekle (add-to-cart) payload’ı size, kendi mağazanızdan oluşturulan mutlak bir bağlantı olan thumbnailUrl’ı verir: bunu tam olarak alındığı gibi saklayın. Bağlantıyı yeniden yazmak, sorgusunu temizlemek veya kendi alan adınız altında yeniden barındırmak görüntünün bozulmasına neden olacaktır.

Mağazanızın güvenebileceği fiyatlar

• Widget kapsamlı bir token fiyat belirleyemez. Onunla istenen teklif yalnız müşterinin formda seçtiği seçenekleri alır; malzeme, makine ve ücret fiyatları her zaman kendi profillerinizden gelir.
• widget.added_to_cart webhook'u tarayıcının gönderdiğini değil, teklifle birlikte kaydedilen fiyatı, para birimini, adedi ve malzemeyi bildirir ve teklif başına bir kez gönderilir.
• Sayfanıza gelen QUOTE3D_ADD_TO_CART mesajı müşterinin tarayıcısından gelir ve orada değiştirilebilir. Ücret almadan önce fiyatı webhook'la ya da GET https://api.quote3d.com/v2/quotes/{quote_id} ile doğrulayın.

Widget Token Kapsamı

Widget kapsamıyla oluşturulan bir token yalnızca gömülü deneyimin gerçekten ihtiyaç duyduğu uç noktalara ulaşabilir. API'deki diğer her şey reddedilir, böylece sayfa kaynağınızdan alınan bir token hesabınıza karşı kullanılamaz.

Widget kapsamının izin verdikleri:

• Teklif formunun seçeneklerinizi gösterebilmesi için yazıcı ve malzeme yapılandırmanızı okumak.
• Bir yükleme kimliği istemek ve model dosyası yüklemek.
• Yüklediği dosyayı okumak ve silmek.
• O dosya için asenkron bir teklif başlatmak ve oluşan işi sorgulamak.
• Bir teklifi kimliğine göre okumak, küçük resmini kaydetmek ve sepete ekleme olayını göndermek.

Widget kapsamının reddettikleri:

• Webhook yönetimi; böylece çalınan bir token olay akışınızı başka bir sunucuya yönlendiremez.
• Hesap bilgileri, yükleme geçmişiniz, teklif listeleri, analitik, kullanım ve kota.
• Lisans etkinleştirme ve yukarıda listelenmeyen diğer her uç nokta.

Kaynak Bağlama

Token'ı kullanabilecek mağazaları listeleyin, örneğin https://shop.example.com. Widget kapsamlı token en az bir tane ister: Quote3D, iframe yüklenirken widget'ı gömen sayfayı kontrol eder ve listede olmayan hiçbir sitede görüntülenmeyi reddeder.

Kaynak bağlamanın sayfanızdan beklediği şey

• Kontrol, tarayıcınızın widget iframe'ini yüklerken gönderdiği yönlendireni okur. Bu varsayılan davranıştır, bu yüzden normal bir sayfadan hiçbir şey gerekmez.
• Sayfanız referrer-policy: no-referrer ayarlıyorsa origin doğrulanamaz ve widget yüklenmez. Widget'ı gömen sayfalarda tarayıcı varsayılanını (strict-origin-when-cross-origin) ya da origin değerini kullanın.
• Doğrudan API çağrıları ayrıca kontrol edilir: listede olmayan bir sitedeki tarayıcıdan gönderilen istek reddedilirken, Origin başlığı göndermeyen sunucudan sunucuya çağrılar etkilenmez.

Bir widget token'ının okuyamadıkları

Yapılandırma uç noktası yalnızca teklif formunun gösterdiklerini döndürür — yazıcı adları, baskı hacimleri, malzemeler, renkler ve katman limitleri. Maliyet tabanınız (kilogram başına malzeme fiyatı, makine saatlik maliyeti, destek maliyeti çarpanı, güç tüketimi) tarayıcıya asla gönderilmez; fiyatlandırma sunucuda hesaplanır.

Ziyaretçi oturumları

Widget token'ı herkese açıktır; token üzerinden sayılan bir sınır mağazanızdaki bütün müşterilerce paylaşılır ve tek bir betik onu tüketip herkesi dışarıda bırakabilir. Bu yüzden widget, müşteri ilk kez dosya yüklediğinde kısa ömürlü bir ziyaretçi oturumu açar ve maliyetli adımlar oturum başına sayılır.

• Gömülü widget bunu kendisi yapar. Standart gömme kodunda değişiklik gerekmez.
• Dosya yükleme, teklif başlatma, küçük resim kaydetme ve sepete ekleme olayı oturum ister. Yapılandırmanızı okumak, bir işi yoklamak ve teklifi getirmek istemez; böylece uzun bir hesaplama müşteriyi yarı yolda bırakmaz.
• Bir oturum 30 dakika geçerlidir. Her oturumda bir müşteri saatte en fazla 30 yükleme, 15 teklif, 30 küçük resim kaydı ve 20 sepete ekleme olayı gönderebilir. Aynı token için bir IP adresi saatte en fazla 20 oturum açabilir.
• Bu kurallar yalnız widget kapsamlı token'lara uygulanır. Kapsamsız bir token sunucu entegrasyonu sayılır ve bu korumaların hiçbirini almaz; bu yüzden mağazanızdaki token her zaman widget kapsamlı olmalıdır.
• Bu uç noktaları widget kapsamlı bir token'la kendiniz çağırıyorsanız önce bir oturum açın: GET https://api.quote3d.com/v2/widget/challenge ile bir sınama alın, tuz ve ardından gelen sayının SHA-256 değeri sınamaya eşit olan sayıyı (0 ile maxnumber arasında) bulun ve POST https://api.quote3d.com/v2/widget/session ile gönderin. Dönen değeri X-Widget-Session başlığında gönderin. Oturum yoksa ya da süresi dolmuşsa 401 ve AUTH_005 hata koduyla cevap verilir; yeni bir oturum açıp isteği tekrarlayın.
• Widget trafiğinin sunucu entegrasyonunuzdan ayrı, kendine ait bir saatlik kotası vardır; böylece yoğun bir mağaza ile kendi arka ucunuz birbirini aksatmaz. Ayrıca panelden widget için günlük bir teklif sınırı belirleyebilirsiniz; sınıra ulaşıldığında müşterilere ertesi gün tekrar denemeleri söylenir ve size e-posta gider.

Kapsamsız oluşturulan token'lar tam erişimi korur, dolayısıyla mevcut entegrasyonlar değişmeden çalışmaya devam eder. Bir token'ı kısıtlamaya dahil etmenin yolu ona kapsam eklemektir.