Die SimplyPrint-API für 3D-Drucker

Druck mit einem API-Aufruf starten

Der schnellste Weg von deinem Code zu einem sich bewegenden Extruder: Sende eine Datei-ID per POST an /queue/AddItem, wähle einen oder mehrere Drucker aus und SimplyPrint übernimmt den Rest. Im Hintergrund führt die Warteschlange dieselbe Zuordnungs-, Freigabe- und Routinglogik aus wie das Panel. So startet der Druck auf demselben Drucker wie beim Klick eines Menschen auf Drucken.

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": "abc123",
    "amount": 1,
    "for_printers": "42,43",
    "position": "top"
  }'

{
  "status": true,
  "message": null,
  "approval_status": "not_required",
  "id": 90817,
  "queue_position": 1
}

Status lesen. Befehle senden. Derselbe Authentifizierungs-Header.

Alle Drucker mit einem Aufruf auflisten. Die Antwort enthält dasselbe Druckerobjekt, das das Panel anzeigt: Status, aktuellen Auftrag, Temperaturen, geladenes Filament, alles.

curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"

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 }'

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 X Y" }'

OAuth2 für Partnerintegrationen

Entwickelst du eine Drittanbieter-App, die andere SimplyPrint-Kunden nutzen sollen? Nutze OAuth2, damit jeder Kunde sein eigenes Konto über einen Zustimmungsbildschirm verbinden kann, keine gemeinsamen API-Schlüssel, keine per Copy-Paste geteilten Geheimnisse. Das ist derselbe Ablauf, den unsere offizielle Cura-Integration nutzt und den wir für Partnerintegrationen auf Plattformen wie Zapier, n8n, Make und Activepieces bereitstellen.

# 1) Send the user to the consent screen
https://simplyprint.io/panel/oauth2/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https://your-app.example.com/callback
  &scope=printers.read+queue.write+files.read
  &state=<random>

# 2) Exchange the returned code for an access token
curl -X POST "https://simplyprint.io/api/0/oauth2/Token" \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_CALLBACK" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=https://your-app.example.com/callback"

# 3) Discover the bound company, then call API as that company
curl "https://simplyprint.io/api/0/account/GetUser" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Die vollständige Referenz findest du auf apidocs.simplyprint.io

Jeder Endpunkt, jede Request- und Response-Struktur, Fehlercodes, OAuth2-Ablauf, Scope-Liste. Die Doku ist auch KI-freundlich, es gibt eine llms.txt für einmaliges Einlesen durch KI und eine strukturierte api/index.json, wenn du Tools auf Grundlage des Katalogs entwickeln möchtest.

Häufig gestellte Fragen