spooly.eu/docs/api/maintenance

Wartung

Das Wartungsbuch: Drucker mit Stunden, Aufgaben mit Status und Fälligkeit, der Verlauf, und Aufgaben erledigen oder zurückstellen.

Als Text öffnen

Auf dieser Seite

Wartungsbuch abrufen

GET/maintenance

status ist due, soon oder ok. metric ist hours, prints, kg, days, print_days. eta_days schätzt die Tage bis fällig, 0 oder weniger heißt überfällig. Es ist null, wenn Spooly noch zu wenig Drucke für eine Schätzung hat oder das Teil als Ersatz im Regal liegt. Aufgabennamen kommen in der Sprache des Kontos.

Parameter

Keine Parameter.

curl "https://spooly.eu/api/v1/maintenance" \
  -H "Authorization: Bearer $SPOOLY_KEY"

Antwort 200

{
  "printers": [
    {
      "printer_id": "e41b7c09a3d65f28b0c94e17d2a86f35",
      "printer": "X1 Carbon von Tobi",
      "hours": 812.5,
      "prints": 640,
      "filament_kg": 41.3,
      "due_count": 1,
      "soon_count": 2,
      "health_score": 84,
      "hours_confirmed": true
    }
  ],
  "tasks": [
    {
      "id": "mc_4f60b9158e2a",
      "printer_id": "e41b7c09a3d65f28b0c94e17d2a86f35",
      "printer": "X1 Carbon von Tobi",
      "name": "Nozzle 0.4 mm",
      "status": "due",
      "metric": "kg",
      "interval": 5,
      "used": 5.2,
      "remaining": -0.2,
      "eta_days": 0,
      "snoozed_until": null,
      "last_done_at": "2026-08-12T09:30:00Z",
      "default_action": "replace"
    }
  ],
  "printers_without_plan": [],
  "due_count": 1,
  "soon_count": 2,
  "snoozed_count": 0
}

Wartungsverlauf

GET/maintenance/log

Neueste zuerst, ohne Fotos. type ist replace, clean, check, service, snooze, setup. Gelöschte Aufgaben bleiben im Verlauf, nur ohne Namen.

Parameter

task_idAbfrage, optional: Nur diese Aufgabe
printer_idAbfrage, optional: Nur dieser Drucker
limitAbfrage, optional: 1 bis 200, Standard 50
offsetAbfrage, optional: 0 bis 1.000.000, Standard 0

curl "https://spooly.eu/api/v1/maintenance/log?task_id=mc_4f60b9158e2a" \
  -H "Authorization: Bearer $SPOOLY_KEY"

Antwort 200

{
  "items": [
    {
      "id": "ml_7b34c4d1e8f2",
      "task_id": "mc_4f60b9158e2a",
      "task": "Nozzle 0.4 mm",
      "printer": "X1 Carbon von Tobi",
      "type": "replace",
      "notes": "Neue Düse 0,4 mm",
      "cost": 12.5,
      "at": "2026-08-12T09:30:00Z"
    }
  ],
  "total": 12,
  "limit": 50,
  "offset": 0
}

Wartung erledigen

POST/maintenance/tasks/{task_id}/complete

Der Zähler beginnt neu, das Lager wird abgezogen, die Fällig-Meldung geht weg. Ohne action gilt default_action der Aufgabe. stock_empty nennt einen Lagerartikel, der dadurch leer wurde.

Parameter

task_idPfad: id der Aufgabe aus GET /maintenance
actionBody, optional: replace, clean oder check
notesBody, optional: Bis 1.000 Zeichen
Idempotency-KeyKopf, optional: 1 bis 128 sichtbare ASCII-Zeichen. Idempotency-Key

curl -X POST "https://spooly.eu/api/v1/maintenance/tasks/mc_4f60b9158e2a/complete" \
  -H "Authorization: Bearer $SPOOLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"replace","notes":"Neue Düse 0,4 mm"}'

Antwort 200

{
  "change_id": 381,
  "spool": null,
  "slot": null,
  "old_grams": null,
  "new_grams": null,
  "replayed": false,
  "task": {
    "id": "mc_4f60b9158e2a",
    "printer_id": "e41b7c09a3d65f28b0c94e17d2a86f35",
    "printer": "X1 Carbon von Tobi",
    "name": "Nozzle 0.4 mm",
    "status": "ok",
    "metric": "kg",
    "interval": 5,
    "used": 0,
    "remaining": 5,
    "eta_days": 0,
    "snoozed_until": null,
    "last_done_at": "2026-11-01T10:15:00Z",
    "default_action": "replace"
  },
  "printer": {
    "printer_id": "e41b7c09a3d65f28b0c94e17d2a86f35",
    "printer": "X1 Carbon von Tobi",
    "hours": 812.5,
    "prints": 640,
    "filament_kg": 41.3,
    "due_count": 0,
    "soon_count": 2,
    "health_score": 84,
    "hours_confirmed": true
  },
  "stock_empty": null,
  "summary": "Wartung Nozzle 0.4 mm an X1 Carbon von Tobi erledigt"
}

Wartung zurückstellen

POST/maintenance/tasks/{task_id}/snooze

Die Aufgabe meldet sich nach den angegebenen Tagen wieder.

Parameter

task_idPfad: id der Aufgabe aus GET /maintenance
daysBody: 7, 14 oder 30
reasonBody, optional: Bis 200 Zeichen
Idempotency-KeyKopf, optional: 1 bis 128 sichtbare ASCII-Zeichen. Idempotency-Key

curl -X POST "https://spooly.eu/api/v1/maintenance/tasks/mc_4f60b9158e2a/snooze" \
  -H "Authorization: Bearer $SPOOLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":14,"reason":"Teil ist bestellt"}'

Antwort 200

{
  "change_id": 381,
  "spool": null,
  "slot": null,
  "old_grams": null,
  "new_grams": null,
  "replayed": false,
  "task": {
    "id": "mc_4f60b9158e2a",
    "printer_id": "e41b7c09a3d65f28b0c94e17d2a86f35",
    "printer": "X1 Carbon von Tobi",
    "name": "Nozzle 0.4 mm",
    "status": "due",
    "metric": "kg",
    "interval": 5,
    "used": 5.2,
    "remaining": -0.2,
    "eta_days": 0,
    "snoozed_until": "2026-11-15T10:15:00Z",
    "last_done_at": "2026-08-12T09:30:00Z",
    "default_action": "replace"
  },
  "printer": null,
  "stock_empty": null,
  "summary": "Wartung Nozzle 0.4 mm um 14 Tage verschoben"
}