Bulutta barındırılan Prusa filonuz için REST API

Prusa Prusa API

SimplyPrint, Prusa filoları için bulut panelidir ve API, kendi yazılımınızın bu filoyu yönetmesini sağlar. Belirli bir MK4'te baskıları kuyruğa alın, XL'de çalışmakta olan işi duraklatın, Mini+'ya G-code komutu gönderin, atölyenizdeki tüm Prusa'ların canlı durumunu alın. Tek başlık, JSON girdi, JSON çıktı. Bir Prusa'nız veya iki yüz Prusa'nız olsa da aynı API çalışır.

API genel bakışını görüntüle Ücretsiz başla Daha fazla bilgi ve kılavuz

Tüm modern Prusa ürün serisiyle uyumlu

MK4, MK4S, MK3.9, MK3.5, Mini+, XL ve CORE One'ın tümü SimplyPrint'e bağlanır ve aynı API arayüzünü sunar. Eski MK3 sınıfı yazıcılar OctoPrint hostu ve eklentimiz üzerinden bağlanır.

Tek API çağrısıyla belirli bir Prusa'da baskıyı kuyruğa alın

Bir dosya ID'sini POST edin, bir yazıcıyı hedefleyin, konumu ayarlayın. SimplyPrint, baskıyı panelin kullandığı aynı kuyruk, onay ve yönlendirme mantığıyla çalıştırır; böylece baskı, bir insan Yazdır'a bastığında başlayacağı gibi Prusa'nızda başlar.

# Queue a print on a specific Prusa MK4 (printer id 42)
curl -X POST "https://api.simplyprint.io/{companyId}/queue/AddItem" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "benchy_gcode_file_id",
    "amount": 1,
    "for_printers": "42",
    "position": "top"
  }'
Belirli bir Prusa yerine SimplyPrint'in en uygun Prusa'yı seçmesini mi istiyorsunuz? for_printers alanını kaldırın. Kuyruk, doğru baskı hacmine ve yüklü filamente sahip, çalışır durumdaki bir Prusa'yı seçer.

SimplyPrint, Prusa yazıcınıza nasıl bağlanır

SimplyPrint, Prusa Connect eklentisi değildir. Sahip olduğunuz yazıcıya göre iki bağlantı yoluyla Prusa yazıcınıza doğrudan bağlanan ayrı bir bulut panelidir:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: SimplyPrint'in açık kaynaklı ürün yazılımı paketini yazıcıya bir kez kurun (şu anda beta). Ürün yazılımı, yazıcının kendi Wi-Fi / Ethernet bağlantısıyla SimplyPrint'e bağlanır. Pi, ikinci kutu veya ana bilgisayar gerekmez; henüz web kamerası desteği yoktur.
  • MK3 / MK3S / MK3S+ (ve eskileri): OctoPrint ana makinesi (Raspberry Pi veya benzeri) ve SimplyPrint OctoPrint eklentimiz üzerinden bağlanır. API açısından yazıcı, ürün yazılımı entegrasyonu yolundakiyle aynı şekilde davranır.
Bağlandıktan sonra yazıcı, API'de standart bir yazıcı nesnesi olarak görünür. GET /printers/Get, yazıcının Prusa, Bambu Lab, Creality veya başka bir marka olmasına bakılmaksızın aynı yapıyı döndürür; böylece donanımınız tek bir markaya bağlı olsa bile kodunuz markadan bağımsız kalır.

Listele, incele, duraklat, sürdür: günlük işlemler

Her yazıcı denetimi uç noktası Prusa'da filonuzdaki diğer tüm yazıcılarla aynı şekilde çalışır. Yazıcı kimliğini gönderin, JSON alın.

# List every printer in the account (Prusa, Bambu, anything)
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"
Firmware'inizin kabul ettiği herhangi bir G-code'u gönderin; Prusa'ya özgü bakım rutinleri, kalibrasyon dizileri veya hızlı düzeltmeler için kullanışlıdır:
# Send a one-off G-code command - home all axes on a Prusa MK4
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/SendGcode" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42, "gcode": "G28" }'
Yazıcının LCD'sine dokunmadan baskıyı duraklatın veya devam ettirin:
# Pause a running print on a Prusa
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/Pause" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42 }'

Kişilerin Prusa API ile geliştirdikleri

ERP bağlantıları, laboratuvar gösterge panoları, Slack/Discord botları ve okul LMS entegrasyonları sık kullanılan örneklerdir. Tüm kullanım örnekleri için ana API sayfasına bakın; oradaki her şey Prusa filosunda da aynı şekilde çalışır.

Prusa Connect API yerine neden SimplyPrint kullanılmalı?

Prusa Connect birçok görünümde salt okunurdur. İzleyebilirsiniz ancak baskı başlatamaz, kuyrukları yönetemez veya uzaktan G-code gönderemezsiniz. SimplyPrint, tek bir REST çağrısından tam yazma yüzeyi sunar. Prusa Connect, Prusa'nın kendi birinci taraf panelidir ve kendi sınırlı API yüzeyini açar. SimplyPrint aynı yazıcılar için daha geniş bir API'nin yanı sıra Prusa Connect'in kapsamadığı özellikleri sunar:

  • Markalar arası filo: Prusa, Bambu Lab, Creality, Anycubic, Elegoo, OctoPrint ana makineleri ve Klipper tabanlı her şey için tek API. Markalar arasında uğraşmak gerekmez.
  • Kuyruk, filament ve iş geçmişi uç noktaları: Yalnızca yazıcı kontrolü değildir. Bekleyen işlerin tam envanteri, filament makarası durumu, geçmiş iş istatistikleri ve özel alanlar sunar.
  • İş ortağı entegrasyonları için OAuth2: kullanıcılarınızın Prusa Connect tokenlarını paylaşmasına gerek kalmadan kendi SimplyPrint hesaplarına bağlayacak bir entegrasyon sunun.
  • Webhook anlık olayları: SimplyPrint, baskı biter bitmez POST gönderir, yoklama yoktur.
SimplyPrint ve Prusa Connect birlikte kullanılabilir; ikisini de çalıştırabilirsiniz. Prusa'nın kendi slicer'ı ve yüklemeleri paralel çalışmaya devam eder. Bulutta dilimleme de mi gerekiyor? Kuyruğa eklemeden önce kendi kodunuzdan STL'yi G-code'a dilimlemek için PrusaSlicer Cloud entegrasyonuna bakın.

PrusaSlicer bulut entegrasyonu

Prusa API için plan erişimi

Ana SimplyPrint API ile aynı plan kısıtlamaları. Free ve Basic planları API sunmaz. Pro ve üzeri Basic API'yi, Print Farm ve üzeri Enhanced'ı etkinleştirir. Enhanced, kuyruk değişiklikleri ve baskı başlatma için yazma yetkisi sunar.

Özellik / sınır Ücretsiz Basic Pro Baskı çiftliği Kurumsal Okul Bulut slicer Filament yöneticisi
Dakika başına API isteği
Hesaptaki tüm API çağrılarının paylaştığı dakika bazlı kayan sınır.
- - 60 180 600 180 - -
Temel API erişimi
Hesaptaki her Prusa için yazıcı durumu, kuyruk, yazdırma işleri ve geçmişi okuyun.
Gelişmiş API (baskı başlatma, G-code gönderme)
Dosya yükleme, baskı başlatan kuyruk değişiklikleri ve doğrudan G-code gönderimini açar.

Planlarımız hakkında daha fazla bilgi ister misiniz?

Tam fiyat ve özellik karşılaştırmasını görüntüle

Webhook'lar ve bulut PrusaSlicer ile doğal olarak birlikte çalışır

Prusa API, daha büyük bir geliştirici yüzeyinin parçasıdır. Prusa baskıyı tamamladığında anlık olaylar almak için webhooks ile eşleştirin. STL dosyalarını kuyruğa eklemeden önce kendi kodunuzdan G-code'a dilimlemek istiyorsanız bulut PrusaSlicer'ımızı kullanın.

Ana API sayfasını incele

Prusa API sık sorulan sorular

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL ve CORE One ürün yazılımı paketiyle bağlanır. Eski MK3 sınıfı yazıcılar (MK3, MK3S, MK3S+) OctoPrint ve eklentimiz üzerinden bağlanır. Bağlandıktan sonra hepsi aynı API arayüzünü sunar.
Hayır. SimplyPrint, Prusa'nızla kendi bağlantısı olan ayrı bir paneldir, Prusa Connect eklentisi değildir. İsterseniz ikisini yan yana çalıştırabilirsiniz, ancak SimplyPrint Prusa Connect gerektirmez.
Evet. Hedef Prusa'nın yazıcı kimliği olan for_printers: "42" ile /queue/AddItem adresine POST gönderdiğinizde kuyruk işi o yazıcıya yönlendirir. Hesabınız kuyruk öğeleri için onay gerektirmedikçe, yazıcı çalışır duruma gelir gelmez baskı başlar.
Evet, /printers/actions/SendGcode belirli bir yazıcıya tek seferlik bir G-code satırı gönderir. Prusa'ya özel bakım, kalibrasyon dizileri veya kurtarma rutinleri için kullanışlıdır. Yazma işlemleri için Enhanced API katmanı, Print Farm veya üzeri gereklidir.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} bir sürüm değil, hesap kimliğinizdir. Oturum açtıktan sonra panel URL'sinde bulabilirsiniz. Kimlik doğrulama tek üst bilgidir: X-API-KEY: your_key_here.
Evet. OAuth2 akışı, her Prusa sahibinin paylaşılmış API anahtarları olmadan onay ekranı aracılığıyla kendi SimplyPrint hesabını uygulamanıza bağlamasını sağlar. Tam OAuth2 ayrıntıları ve istemci istek formu için ana API sayfasına bakın.

İçindekiler