Quote3D Dokümantasyonuna Hoş Geldiniz! ⏳
Quote3D LogoQuote3DDokümantasyon

Hızlı Başlangıç Rehberi 🚀

Quote3D API ile 5 dakikadan kısa sürede çalışmaya başlayın! Harici entegrasyonlar için https://api.quote3d.com/v2 adresindeki uç noktaları çağırın. Hesabınızı oluşturmak, bir API token'ı oluşturmak ve ilk API çağrılarınızı yapmaya başlamak için bu adımları izleyin.

1

Hesabınızı Oluşturun

  1. Yeni bir hesap oluşturmak için Quote3D kontrol paneline gidin
  2. Kayıt formunu bilgilerinizle doldurun
  3. Hesabınızı tamamen etkinleştirmek için e-postanızı kontrol edin ve onay bağlantısına tıklayın

E-posta adresinizi onayladığınızdan emin olun, aksi takdirde hesabınız tamamen etkinleştirilmeyecek ve API'ye erişemeyeceksiniz!

2

API Token'ınızı Oluşturun

  1. Quote3D hesabınıza giriş yapın
  2. Dashboard'a gidin - giriş yaptıktan sonra otomatik olarak buraya yönlendirileceksiniz
  3. Sol kenar çubuğundaki Tokens sekmesine tıklayın
  4. New Token butonuna tıklayarak yeni bir token oluşturun
  5. Token'ınızı yapılandırın
    • Açıklayıcı bir ad verin (örneğin, "İlk Token'ım")
    • Süre sonunu gün olarak ayarlayın (süresiz yapmak için boş bırakın)
  6. Oluşturulan token'ı hemen kopyalayın ve güvenli bir yerde saklayın

Token'ı sadece bir kez göreceksiniz! Popup'ı kapatmadan önce kopyalayıp güvenli bir yerde sakladığınızdan emin olun.

3

API ile Kimlik Doğrulama

  1. /docs/playground adresindeki API Playground'a gidin
  2. Sağ üst köşedeki kilit simgesine tıklayın
  3. Adım 2'deki JWT token'ınızı yetkilendirme alanına yapıştırın
  4. Authorize'a Authorize

🎉 Tebrikler! Artık kimlik doğrulaması yaptınız ve Quote3D API'sini keşfetmeye hazırsınız.

4

İlk API Çağrınızı Yapın

Test etmeye hazır mısınız? İlk STL dosyanızı yüklemeyi deneyin:

  1. API dokümantasyonunda POST https://api.quote3d.com/v2/file endpoint'ini bulun
  2. POST isteği detaylarını görmek için sekmeyi genişletin
  3. Dosya gezgininizi açmak için "dosya seç" butonunu kullanarak bir STL dosyası yükleyin
  4. İsteği çalıştırın

Yanıt, şunlar için kullanabileceğiniz bir dosya kimliği içerecektir:

  • Boyutları ve yazdırılabilirliği kontrol etme
  • Otomatik anında fiyatlandırma tahminleri için fiyat teklifleri oluşturma
  • Bulut depolama alanınızdan tasarruf etmek için yüklenen dosyayı yönetme

file_id, sonraki API çağrılarında yüklediğiniz dosyaları yönetmek ve referanslamak için anahtarınızdır. Diğer tüm API çağrılarının temelini oluşturan benzersiz tanımlayıcıdır.

Endpoint Karar Ağacı

https://api.quote3d.com/v2 adresinde bir sonraki hangi endpoint'i çağıracağınıza karar verirken bu hızlı yolu kullanın.

  1. Backend üzerinden mi yükleme yapmanız gerekiyor? Bearer token'ınız ile POST https://api.quote3d.com/v2/file kullanın.
  2. Token'ınızı açığa çıkarmadan doğrudan tarayıcı üzerinden yükleme mi yapmak istiyorsunuz? GET https://api.quote3d.com/v2/file/upload-id üzerinden bir yükleme kimliği alın, ardından POST https://api.quote3d.com/v2/file/public/{upload_id} ile yükleme yapın.
  3. Fiyatlandırmadan önce boyut/uyumluluk doğrulamasına mı ihtiyacınız var? POST https://api.quote3d.com/v2/printability/{file_id} çağrısını yapın.
  4. Teklif mi istiyorsunuz? POST https://api.quote3d.com/v2/file/quote/{file_id} ile başlayın.
  5. Teklifin tamamlanması mı bekleniyor? COMPLETED, FAILED veya CANCELLED olana kadar https://api.quote3d.com/v2/jobs/{job_id} adresini GET ile sorgula.
  6. Kayıtlı teklif geçmişine/detaylarına mı ihtiyacınız var? GET https://api.quote3d.com/v2/quotes ve GET https://api.quote3d.com/v2/quotes/{quote_id} kullanın.

Not: Teklif isteklerinde teknoloji, yazıcı veya malzeme detaylarını göndermezseniz, API varsayılan kullanıcı profili ayarlarınıza döner.

Yaygın Hatalar ve Sonraki Adımlar

En yaygın uç durumlar için hızlı eylemler.

429 İstek Sınırı Aşıldı: X-RateLimit-* ve Retry-After başlıklarını okuyun, bekleyin, ardından üstel geri çekilme ile tekrar deneyin.

Geçersiz Dosya Formatı: Yalnızca STL, 3MF veya OBJ yükleyin. Modeli yeniden dışa aktarın ve dosya bütünlüğünü doğrulayın.

Model Tablaya Sığmıyor: Önce basılabilirlik kontrolünü çalıştırın, model ölçeğini küçültün veya daha büyük bir yazıcı profili/baskı hacmi seçin.

Birim Anomali Uyarısı: Modeliniz muhtemelen inç/metre ölçeği kullanıyor. Milimetre (mm) cinsinden yeniden dışa aktarın ve tekrar deneyin.

Sonraki Adımlar?

Kurulumunuzu tamamladığınıza göre, bu temel özellikleri keşfedin:

  • Dosya Yönetimi - 3D model dosyalarınızı (STL, 3MF, OBJ) yükleyin, indirin ve yönetin
  • Yazdırılabilirlik Kontrolü - Modellerinizin yazıcı boyutlarınıza uyup uymadığını doğrulayın
  • Fiyat Teklifi Oluşturma - Tercih ettiğiniz para biriminde, detaylı malzeme kullanımı ve baskı süresi tahminleri ile anında fiyatlandırma alın
  • Fiyat Teklifi Geçmişi - Tüm geçmiş fiyat tekliflerinize erişin ve yönetin
  • Webhooks - Fiyat teklifi tamamlanmaları ve dosya yüklemeleri için gerçek zamanlı bildirimler alın
  • Analitik - Kullanımınızı, popüler malzemeleri ve maliyet trendlerini takip edin
  • Hesap Yönetimi - Kotlarınızı, kullanım istatistiklerinizi ve abonelik detaylarınızı izleyin

Önemli: Tüm API endpoint'leri Bearer token ile kimlik doğrulaması gerektirir. Her isteğin Authorization başlığına eklediğinizden emin olun.

Örnek: Authorization: Bearer YOUR_TOKEN_HERE

Yardıma mı ihtiyacınız var? Temel Kavramlar kılavuzumuza bakın veya interaktif dokümantasyon için API Playground'ı keşfedin.