DokuHome AssistantZur AppEN

spooly.eu/docs/api/slots

Slots

Welche Spule in welchem Slot steckt, über alle Hersteller in einer Form. Ändern geht nur mit aktivem Slot-Autopilot.

Als Text öffnen
Auf dieser Seite

Slots auflisten

GET/slots

Ein Eintrag je Slot. spool ist null bei einem leeren Slot oder einer Spule, die Spooly nicht kennt. slot_id ist leer, wenn der Slot-Autopilot für das Konto nicht aktiv ist. printer ist der Name des Druckers, eine eigene Drucker-ID gibt es hier nicht.

Parameter

Keine Parameter.

curl "https://spooly.eu/api/v1/slots" \
  -H "Authorization: Bearer $SPOOLY_KEY"
Antwort 200
{
  "items": [
    {
      "printer": "X1 Carbon von Tobi",
      "slot": "1-2",
      "spool": {
        "id": "7f3c2a10-5e1b-4c8e-9a44-2d6b1f0c7e21",
        "number": 1,
        "title": "Jade White",
        "material": "PLA",
        "color_hex": "#E8E9DF"
      },
      "slot_id": "9c1e4b7a2f6d08e35ab1c47d9e20f6a3"
    }
  ]
}

Slot zuordnen

PUT/slots/{slot_id}

Meldet der Drucker eine andere Farbe, antwortet die API mit 409 andere_farbe. Mit confirm_color ordnest du trotzdem zu.

Parameter

slot_idPfad
Aus GET /slots
spool_idBody
Die Kennung der Spule
confirm_colorBody, optional
true, wenn die andere Farbe gewollt ist. Standard false.
Idempotency-KeyKopf, optional
1 bis 128 sichtbare ASCII-Zeichen. Idempotency-Key
curl -X PUT "https://spooly.eu/api/v1/slots/9c1e4b7a2f6d08e35ab1c47d9e20f6a3" \
  -H "Authorization: Bearer $SPOOLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spool_id":"7f3c2a10-5e1b-4c8e-9a44-2d6b1f0c7e21","confirm_color":false}'
Antwort 200
{
  "change_id": 381,
  "spool": null,
  "slot": {
    "printer": "X1 Carbon von Tobi",
    "slot": "1-2",
    "spool": {
      "id": "7f3c2a10-5e1b-4c8e-9a44-2d6b1f0c7e21",
      "number": 1,
      "title": "Jade White",
      "material": "PLA",
      "color_hex": "#E8E9DF"
    },
    "slot_id": "9c1e4b7a2f6d08e35ab1c47d9e20f6a3"
  },
  "old_grams": null,
  "new_grams": null,
  "replayed": false,
  "task": null,
  "printer": null,
  "stock_empty": null,
  "summary": "Spule #1 Jade White einem Slot zugeordnet"
}

Slot leeren

DELETE/slots/{slot_id}

Die Spule bleibt in Spooly, sie steckt nur nicht mehr im Slot. Das ist der einzige DELETE der API.

Parameter

slot_idPfad
Aus GET /slots
Idempotency-KeyKopf, optional
1 bis 128 sichtbare ASCII-Zeichen. Idempotency-Key
curl -X DELETE "https://spooly.eu/api/v1/slots/9c1e4b7a2f6d08e35ab1c47d9e20f6a3" \
  -H "Authorization: Bearer $SPOOLY_KEY"
Antwort 200
{
  "change_id": 381,
  "spool": null,
  "slot": {
    "printer": "X1 Carbon von Tobi",
    "slot": "1-2",
    "spool": null,
    "slot_id": "9c1e4b7a2f6d08e35ab1c47d9e20f6a3"
  },
  "old_grams": null,
  "new_grams": null,
  "replayed": false,
  "task": null,
  "printer": null,
  "stock_empty": null,
  "summary": "Slot geleert"
}