Ein gehosteter Ersatz für die OctoPrint REST-API mit Flottenunterstützung

OctoPrint OctoPrint-API-Alternative

Wenn du heute Code für die REST-API von OctoPrint nutzt, bietet SimplyPrint eine gehostete, flottenweite Alternative. Dieselben Vorgänge pro Drucker: starten, pausieren, fortsetzen, G-code senden und Status abrufen, aber über alle Drucker in deinem Konto mit einem API-Schlüssel, einem OAuth2-Ablauf und einer Basis-URL. Nutze sie über unser Plugin neben deinen bestehenden OctoPrint-Hosts oder verzichte bei firmwareintegrierten Druckern vollständig auf den Pi.

API overview देखें मुफ़्त में शुरू करें और जानकारी और तरीका
सुविधा छवि

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.

Anleitung zur Plugin-Einrichtung
सुविधा छवि
सुविधा छवि

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.
Brauchst du Hilfe, einen bestimmten OctoPrint-Endpunkt dem SimplyPrint-Äquivalent zuzuordnen? Die vollständige API-Referenz listet alle Endpunkte mit Beispielen auf.

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.

क्या आप हमारी योजनाओं के बारे में और जानना चाहते हैं?

पूरी कीमत और सुविधाओं की तुलना देखें

Häufige Fragen zum OctoPrint-Ersatz

Nein. Das SimplyPrint-OctoPrint-Plugin läuft in OctoPrint, daher läuft OctoPrint normal weiter. Der Vorteil ist, dass die SimplyPrint-Cloud-API jeden Drucker der Flotte über eine Basis-URL verfügbar macht, statt jeden Pi einzeln anzusprechen.
Ja. Das SimplyPrint-Plugin läuft neben allen anderen installierten OctoPrint-Plugins. Weder die OctoPrint-Oberfläche noch die REST-Schnittstelle werden entfernt, beide funktionieren weiter.
Wenn deine Drucker unterstützt werden, kannst du OctoPrint weglassen und einen anderen Weg nutzen: die Prusa-MK4-Familie über das Open-Source-Firmwarepaket von SimplyPrint (Beta, noch keine Webcam) oder Klipper über Moonraker auf dem bestehenden Klipper-Host. Bambu Lab-Drucker werden über die SimplyPrint Bambu Lab Client-Bridge auf einem Raspberry Pi oder Mini-PC angebunden. In beiden Fällen behandelt die API den Drucker gleich.
Beim ersten Verbinden vergibt SimplyPrint eine stabile numerische Drucker-ID. Die ID befindet sich im SimplyPrint-Konto, nicht auf dem Host. Wenn du einen Drucker von einem Pi auf einen anderen verschiebst, ändert sich die Drucker-ID nicht, die dein API-Code nutzt.
Ja, das ist der empfohlene Migrationsweg. Installiere das SimplyPrint-Plugin, portiere einen Endpunkt nach dem anderen und lasse die OctoPrint REST-Oberfläche aktiv, bis du dem SimplyPrint-Codepfad vertraust.
Ja. Über den OAuth2-Flow kann jeder Shop sein eigenes SimplyPrint-Konto per Zustimmungsbildschirm mit deiner App verbinden, ohne API-Schlüssel gemeinsam zu nutzen. Auf der zentralen API-Seite findest du Details zu OAuth2 und das Formular zur Beantragung eines OAuth2-Clients.

विषय सूची