REST API dla floty Prusa, hostowane w chmurze

Prusa Prusa API

SimplyPrint to panel chmurowy dla flot Prusa, a API pozwala własnemu oprogramowaniu sterować tą flotą. Można ustawiać wydruki w kolejce dla konkretnego MK4, wstrzymać działające zadanie na XL, wysłać polecenie G-code do Mini+ i pobrać bieżący stan każdej drukarki Prusa w pracowni. Jeden nagłówek, JSON wejściowy, JSON wyjściowy. To samo API działa zarówno dla jednej drukarki Prusa, jak i dwustu.

Ver resumen de API Empezar gratis Más información y guía

Zgodność z całą obecną ofertą Prusa

MK4, MK4S, MK3.9, MK3.5, Mini+, XL i CORE One łączą się z SimplyPrint i udostępniają ten sam zestaw API. Starsze drukarki klasy MK3 łączą się przez hosta OctoPrint i naszą wtyczkę.

Dodawanie wydruku do kolejki na konkretnej drukarce Prusa jednym wywołaniem API

Przesłanie metodą POST ID pliku, wskazanie drukarki i ustawienie pozycji powoduje uruchomienie wydruku przez SimplyPrint z użyciem tej samej kolejki oraz logiki zatwierdzania i routingu, której używa panel, dlatego wydruk rozpoczyna się na drukarce Prusa tak, jak gdyby człowiek wybrał opcję Drukuj.

# 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"
  }'
Ma być wybierana najlepiej dopasowana drukarka Prusa zamiast konkretnej? Wystarczy pominąć pole for_printers, a kolejka wybierze działającą drukarkę Prusa z odpowiednim obszarem roboczym i załadowanym filamentem.

Jak SimplyPrint łączy się z drukarkami Prusa

SimplyPrint nie jest wtyczką Prusa Connect. To osobny panel chmurowy, który łączy się bezpośrednio z drukarkami Prusa na dwa sposoby, zależnie od modelu:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: na drukarce instaluje się jednorazowo pakiet firmware SimplyPrint typu open source, obecnie w becie. Firmware komunikuje się z SimplyPrint przez Wi-Fi / Ethernet drukarki, bez Pi, drugiego urządzenia, komputera hosta i jeszcze bez obsługi kamer internetowych.
  • MK3 / MK3S / MK3S+ (i starsze): połączenie przez hosta OctoPrint (Raspberry Pi lub podobny) oraz naszą wtyczkę SimplyPrint do OctoPrint. Z perspektywy API drukarka zachowuje się identycznie jak na ścieżce integracji z firmware.
Po podłączeniu drukarka pojawia się w API jako standardowy obiekt drukarki. GET /printers/Get zwraca tę samą strukturę niezależnie od tego, czy jest to Prusa, Bambu Lab, Creality czy inna drukarka, więc kod pozostaje niezależny od marki, nawet jeśli sprzęt taki nie jest.

Wyświetlanie, inspekcja, wstrzymywanie, wznawianie: codzienne operacje

Każdy punkt końcowy sterowania drukarką działa tak samo na drukarce Prusa, jak na każdej innej drukarce we flocie. Wystarczy przekazać ID drukarki, aby otrzymać JSON.

# 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"
Można wysłać dowolny G-code obsługiwany przez oprogramowanie sprzętowe, przydatny w procedurach konserwacji dla Prusa, sekwencjach kalibracji lub szybkich poprawkach:
# 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" }'
Wstrzymać lub wznowić wydruk bez dotykania LCD drukarki:
# 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 }'

Co ludzie tworzą za pomocą API Prusa

Integracje z ERP, pulpity laboratorium, boty Slack/Discord i integracje z LMS szkoły to typowe zastosowania. Pełna lista przypadków użycia znajduje się na głównej stronie API; wszystko działa tam tak samo z flotą Prusa.

Dlaczego warto wybrać SimplyPrint zamiast API Prusa Connect?

Prusa Connect w wielu widokach umożliwia tylko odczyt: można monitorować, ale nie rozpoczynać wydruków, zarządzać kolejkami ani zdalnie wysyłać G-code. SimplyPrint zapewnia pełny dostęp do zapisu za pomocą jednego wywołania REST. Prusa Connect to własny panel Prusa i udostępnia własne, ograniczone API. SimplyPrint zapewnia szersze API dla tych samych drukarek oraz funkcje, których Prusa Connect nie obejmuje:

  • Flota wielu marek: jedno API dla Prusa, Bambu Lab, Creality, Anycubic, Elegoo, hostów OctoPrint i wszystkiego opartego na Klipper. Bez żonglowania markami.
  • Endpointy kolejki, filamentu i historii zadań: nie tylko sterowanie drukarkami - pełny wykaz oczekujących zadań, stan szpul filamentu, statystyki wcześniejszych zadań i pola własne.
  • OAuth2 dla integracji partnerów: integracja umożliwia użytkownikom połączenie własnego konta SimplyPrint zamiast udostępniania tokenów Prusa Connect.
  • Zdarzenia push Webhook: SimplyPrint wysyła POST, gdy wydruk się kończy, bez odpytywania.
SimplyPrint i Prusa Connect mogą współistnieć, korzystanie z obu jest możliwe, a własny slicer i przesyłanie plików Prusa nadal działają równolegle. Slicowanie w chmurze też jest potrzebne? Integracja PrusaSlicer Cloud pozwala slicować STL do G-code z własnego kodu przed dodaniem do kolejki.

Chmurowa integracja PrusaSlicer

Dostęp w planach do API Prusa

Takie same ograniczenia planów jak w głównym API SimplyPrint. Plany Free i Basic nie udostępniają API; Pro i wyższe odblokowują Basic API; Print Farm i wyższe odblokowują Enhanced (możliwość zapisu przy modyfikacji kolejki i uruchamianiu wydruków).

Función / límite Gratis Básico Pro Granja de impresión Enterprise Escuela Cloud Slicer Gestor de filamento
Żądania API na minutę
Kroczący limit liczby wywołań na minutę, wspólny dla wszystkich wywołań API konta.
- - 60 180 600 180 - -
Dostęp do podstawowego API
Odczyt stanu drukarki, kolejki wydruku, zadań i historii dla każdej drukarki Prusa na koncie.
Rozszerzone API (rozpoczynanie wydruków, wysyłanie G-code)
Odblokowuje przesyłanie plików, modyfikacje kolejki uruchamiające wydruki i bezpośrednie wysyłanie G-code.

¿Quieres saber más sobre nuestros planes?

Ver precios y comparativa completa de funciones

Współpracuje z webhookami i chmurową wersją PrusaSlicer

API Prusa to część szerszej platformy dla programistów. Można połączyć je z webhookami do zdarzeń push, gdy drukarka Prusa kończy wydruk, oraz z naszym chmurowym PrusaSlicer, aby z własnego kodu przetwarzać pliki STL na G-code przed dodaniem ich do kolejki.

Zobacz główną stronę API

Najczęściej zadawane pytania o Prusa API

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL i CORE One łączą się przez pakiet firmware. Starsze drukarki klasy MK3 (MK3, MK3S, MK3S+) łączą się przez OctoPrint i naszą wtyczkę. Po połączeniu wszystkie udostępniają ten sam zestaw API.
Nie. SimplyPrint to oddzielny panel z własnym połączeniem z drukarką Prusa, nie wtyczka Prusa Connect. Oba można uruchomić równolegle, ale SimplyPrint nie wymaga Prusa Connect.
Tak. Po wysłaniu żądania POST do /queue/AddItem z parametrem for_printers: "42" (ID docelowej drukarki Prusa) kolejka wydruków skieruje zadanie do tej drukarki. Druk rozpocznie się, gdy tylko drukarka będzie gotowa, chyba że konto wymaga zatwierdzania pozycji kolejki.
Tak, /printers/actions/SendGcode wysyła jednorazową linię G-code do określonej drukarki. Przydaje się do konserwacji drukarek Prusa, sekwencji kalibracji lub procedur przywracania działania. Do operacji zapisu wymagany jest poziom Enhanced API, dostępny w planie Print Farm lub wyższym.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} to identyfikator konta, nie wersja. Można go znaleźć w adresie URL panelu po zalogowaniu. Do uwierzytelnienia wystarczy jeden nagłówek: X-API-KEY: your_key_here.
Tak. Przepływ OAuth2 pozwala każdemu właścicielowi Prusa połączyć własne konto SimplyPrint z aplikacją przez ekran zgody, bez wspólnych kluczy API. Pełne informacje o OAuth2 i formularz żądania klienta znajdują się na głównej stronie API.

Índice de contenidos