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.

Visa översikt över API Kom igång gratis Mer info och guide
Funktionsbild

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
Funktionsbild
Funktionsbild

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.

Funktionsbild
Funktionsbild

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).

Funktion / gräns Gratis Grundläggande Pro Skrivarfarm Enterprise Skola Cloud Slicer Filament Manager
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.

Vill du veta mer om våra planer?

Visa fullständig pris- och funktionsjämförelse

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.

Innehållsförteckning