DokuHome AssistantZur AppEN

spooly.eu/docs/api/statistics

Statistik

Die Zahlen aus der Statistik der App: Drucke, Verbrauch, Kosten, Materialien, Drucker und Lager.

Als Text öffnen

Statistik abrufen

GET/statistics

Ohne Angabe alles, mit year ein Jahr, mit year und month ein Monat. Ein Monat ohne Jahr ergibt 422. Monate gelten in der Zeitzone des Kontos. filament_cost zählt nur Spulen mit Preis, Fehldrucke zählen mit. previous ist der gleich lange Zeitraum davor, top_spools die zehn meistgenutzten Spulen. Die id einer Spule dort ist null, wenn es die Spule nur noch im Druck gibt, etwa nach dem Löschen.

Parameter

yearAbfrage, optional
2000 bis 2100
monthAbfrage, optional
1 bis 12
curl "https://spooly.eu/api/v1/statistics?year=2026&month=10" \
  -H "Authorization: Bearer $SPOOLY_KEY"
Antwort 200
{
  "period": "2026-10",
  "currency": "EUR",
  "prints": 9,
  "failed_prints": 1,
  "grams": 327,
  "hours": 41.5,
  "filament_cost": 6.54,
  "grams_without_price": 0,
  "failed_grams": 12,
  "failed_cost": 0.24,
  "previous": {
    "prints": 11,
    "grams": 402,
    "hours": 48,
    "filament_cost": 8.04
  },
  "months": [
    {
      "month": "2026-10",
      "prints": 9,
      "grams": 327,
      "hours": 41.5,
      "filament_cost": 6.54
    }
  ],
  "materials": [
    {
      "name": "PLA",
      "prints": 9,
      "failed_prints": 1,
      "hours": 41.5
    }
  ],
  "printers": [
    {
      "name": "X1 Carbon von Tobi",
      "prints": 9,
      "failed_prints": 1,
      "hours": 41.5
    }
  ],
  "top_spools": [
    {
      "id": "7f3c2a10-5e1b-4c8e-9a44-2d6b1f0c7e21",
      "number": 1,
      "title": "Jade White",
      "grams": 215
    }
  ],
  "stock": {
    "active_spools": 23,
    "remaining_grams": 11840,
    "stock_value": 236.8,
    "spools_without_price": 2,
    "total_spent": 412.5,
    "average_price_per_gram": 0.02
  }
}