OctoPrint + SimplyPrint = eine Cloud-REST-API für die ganze Flotte
SimplyPrint läuft neben OctoPrint, es ersetzt OctoPrint nicht lokal auf dem Pi. Das SimplyPrint-OctoPrint-Plugin verbindet deine vorhandenen OctoPrint-Hosts mit unserer Cloud, und deine vorhandenen OctoPrint-API-Integrationen auf diesen Hosts funktionieren weiter. Der Vorteil ist REST für die gesamte Flotte: eine Basis-URL für jeden Drucker.
Eine REST-API für jeden Drucker, nicht eine pro Pi
Wenn du bisher mit http://pi-1.local/api/printer, http://pi-2.local/api/printer und so weiter kommuniziert hast, kennst du das Problem: Authentifizierung je Host, Firewall-Freigaben je Host, SSL je Host, keine gemeinsame Druckwarteschlange, kein gemeinsamer Filamentbestand. SimplyPrint ersetzt das durch eine Cloud-REST-API für die gesamte Flotte.
# Queue a print on a printer connected via the SimplyPrint OctoPrint plugin
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": "your_gcode_file_id",
"amount": 1,
"for_printers": "17",
"position": "top"
}'
Die Drucker-ID gilt für die gesamte Flotte und bleibt stabil. Der Host-Rechner dahinter erscheint nicht in der API. Verschiebst du einen Drucker von einem Pi auf einen anderen, ändert sich die Drucker-ID nicht.
So funktioniert die Verbindung: das SimplyPrint-OctoPrint-Plugin
SimplyPrint verbindet sich über unser offizielles OctoPrint-Plugin mit Druckern, die über OctoPrint gehostet werden. Installiere es einmal pro Host, das Plugin verknüpft den Drucker mit deinem SimplyPrint-Konto und anschließend erscheint der Drucker als Standarddruckerobjekt in der SimplyPrint API.
- OctoPrint läuft weiter: deine bestehende OctoPrint-Oberfläche, deine bestehenden OctoPrint-Plugins und deine bestehenden OctoPrint-REST-Integrationen auf diesem Host funktionieren weiterhin.
- SimplyPrint ergänzt eine Flottenebene: das Cloud-Panel, die Cloud-REST-API, OAuth2, Webhooks, Dateispeicher, Druckwarteschlangen für mehrere Drucker. Dafür musst du OctoPrints eigene Konfiguration nicht anpassen.
- OctoPrint überspringen, sofern unterstützt: Drucker der Prusa-MK4-Familie können das Open-Source-Firmware-Paket von SimplyPrint nutzen, derzeit in Beta und noch ohne Webcam, und Klipper-Drucker verbinden sich über Moonraker auf dem vorhandenen Klipper-Host statt über OctoPrint. In beiden Fällen behandelt die API sie als dasselbe Druckerobjekt.
Druckerstatus lesen, Befehle senden
Jeder Endpunkt zur Druckersteuerung funktioniert gleich, unabhängig davon, ob der Drucker von OctoPrint gehostet wird oder anders verbunden ist. Übergib die Drucker-ID, erhalte JSON zurück.
# List every printer in the account - identical shape regardless of host
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
-H "X-API-KEY: your_api_key_here"
Sende beliebigen G-code, den deine Firmware akzeptiert, damit bestehende G-code-gesteuerte Automatisierungen von OctoPrint stattdessen über SimplyPrint weiterlaufen:
# Send a one-off G-code line through the SimplyPrint OctoPrint plugin
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": 17, "gcode": "M115" }'
Was SimplyPrint zusätzlich zur REST-API von OctoPrint bietet
OctoPrints REST ist pro Host und druckerorientiert. SimplyPrint ergänzt die Grundlagen für Flotten. Druckwarteschlange für mehrere Drucker, Webhooks und dauerhafter Auftragsverlauf sind die drei meistgenutzten SimplyPrint-Funktionen, die in OctoPrints REST-API fehlen:
- Druckwarteschlange für mehrere Drucker mit Freigabe und Routing: /queue/AddItem wählt automatisch einen kompatiblen Drucker, oder du steuerst einen bestimmten an. Kein spezieller "Welcher Pi ist frei?"-Code mehr.
- Webhook-Push-Ereignisse: SimplyPrint sendet per POST Warteschlangen-, Datei-, Drucker-, Job- und Filament-Ereignisse an deine URL, sobald sie eintreten. Kein Polling, keine verpassten Ereignisse.
- OAuth2-Ablauf für Partner-Apps: Lass andere Shops ihr eigenes SimplyPrint-Konto über einen Zustimmungsbildschirm mit deinem Tool verbinden, bei einer OctoPrint-REST-API pro Host ist das keine praktikable Lösung.
- Filamentverwaltung: Alle Spulen in deiner Werkstatt auslesen, nicht nur das im Hotend des Druckers geladene Filament. Gewichtsverfolgung je Druck, Marke, Material, Farbe und Trocknungsstatus.
- Endpunkte für Auftragsverlauf und Statistiken: frühere Aufträge filtern, archivieren sowie Kosten- und Zeitdaten über die gesamte Flotte abrufen, nicht pro Host.
- MCP-Server für KI-Agenten: dieselbe Flotte steht Claude, ChatGPT und Gemini als native Tool-Oberfläche zur Verfügung.
Migration von einer OctoPrint-REST-Integration
Wenn du bereits funktionierenden REST-Code für OctoPrint hast, erfolgt die Migration schrittweise, beide können parallel laufen, während du umstellst:
- 1. Installiere das SimplyPrint-OctoPrint-Plugin auf jedem Host, auf dem bereits OctoPrint läuft. Das Plugin deaktiviert die REST-API von OctoPrint nicht. Beide Schnittstellen bleiben aktiv.
- 2. Erzeuge einen SimplyPrint-API-Schlüssel unter Kontoeinstellungen → API.
- 3. Portiere jeweils einen Endpunkt: Beginne mit nur lesbaren Endpunkten (/printers/Get, /queue/GetItems), bevor du Schreibzugriffe migrierst.
- 4. Webhooks einrichten, um das OctoPrint-Ereignislistener-Muster zu ersetzen, das du verwendet hast: SimplyPrint sendet Ereignisse an deine URL, statt auf jedem Pi eine Plugin-Schleife auszuführen.
- 5. Die Endpunkte pro Host entfernen, sobald dein Code nur noch über die SimplyPrint-Cloud liest und schreibt.
Plan-Zugriff für die SimplyPrint-Cloud-REST-API
Gleiche Tarifbeschränkungen wie bei der Haupt-API von SimplyPrint. Free- und Basic-Tarife bieten keine API, Pro und höher schalten Basic API frei, Print Farm und höher Enhanced (Schreibzugriff für Änderungen an der Warteschlange und zum Starten von Drucken).
| सुविधा / सीमा | मुफ़्त | Basic | प्रो | प्रिंट फार्म | एंटरप्राइज़ | स्कूल | Cloud Slicer | फिलामेंट मैनेजर |
|---|---|---|---|---|---|---|---|---|
|
API-Anfragen pro Minute
Gemeinsames gleitendes Limit pro Minute für alle API-Aufrufe im Konto.
|
- | - | 60 | 180 | 600 | 180 | - | - |
|
Basis-API-Zugriff
Druckerstatus, Druckwarteschlange, Aufträge und Verlauf für jeden verbundenen Drucker lesen.
|
||||||||
|
Erweiterte API (Drucke starten, G-code senden)
Ermöglicht Datei-Uploads, Warteschlangenänderungen, die Drucke starten, und direktes Senden von G-code.
|
||||||||
|
Webhooks (als Ersatz für OctoPrint-Event-Listener)
Ab dem Print-Farm-Tarif. Push-Ereignisse für Druckwarteschlange, Dateien, Drucker, Druckaufträge und Filament.
|
क्या आप हमारी योजनाओं के बारे में और जानना चाहते हैं?
पूरी कीमत और सुविधाओं की तुलना देखें
OctoPrint-API-Alternative