Schlüssel und Anmeldung
Ein eigenes Programm meldet sich mit einem Schlüssel an. Claude, ChatGPT, Claude Code und Home Assistant melden sich per Klick an, ohne dass du einen Schlüssel kopierst.
Auf dieser Seite
Schlüssel anlegen
- Öffne Spooly im Browser: Einstellungen, Geräte & Schlüssel, „Schlüssel anlegen“. In den Apps siehst du deine Verbindungen, neue legst du im Browser an.
- Gib ihm einen Namen, damit du ihn in der Liste wiedererkennst, und wähl die Art.
- Schalte „Darf auch ändern“ ein, wenn dein Programm schreiben soll.
- Kopier den Schlüssel. Er beginnt mit
spk_, und Spooly zeigt ihn nur dieses eine Mal. In der Liste stehen danach nur die ersten acht Zeichen.
| Art | Wofür |
|---|---|
| Home Assistant | Für die Integration, wenn du dich dort nicht per Klick anmeldest |
| KI-Assistent | Für KIs, die sich nicht selbst anmelden können |
| Tabelle | Nur für den Tabellen-Link. Er kann nur lesen und gilt nicht für die übrige API. |
| Klipper-Drucker | Nur für die Spoolman-Adresse eines Klipper-Druckers. Er liest Spulen und meldet Verbrauch, an der übrigen API gilt er nicht. Klipper |
| Sonstiges | Für dein eigenes Programm |
Schlüssel mitschicken
Jede Anfrage trägt den Schlüssel im Kopf. Nur dieser Kopf öffnet die API. Eine Sitzung aus der App zählt hier nicht, und ein Schlüssel öffnet keine Seite der App.
Authorization: Bearer spk_dein_schluesselhttps://spooly.eu/api/v1Lesen und ändern
Ohne „Darf auch ändern“ kann ein Schlüssel nur lesen. Jede ändernde Anfrage antwortet dann mit 403 insufficient_. Das Recht legst du beim Anlegen fest. Brauchst du es später, leg einen neuen Schlüssel an und widerruf den alten.
Anmeldung per Klick
Bekannte Apps melden sich über OAuth an. Du landest auf einer Seite von Spooly, siehst, was die App lesen darf, und entscheidest mit dem Schalter „Auch ändern erlauben“, ob sie auch schreiben darf. Andere KI-Assistenten können sich auf demselben Weg anmelden. Spooly nennt sie dort „KI-Assistent“ und zeigt die Adresse, zu der die Anmeldung zurückführt.
| App | „Auch ändern erlauben“ |
|---|---|
| Claude | Vorausgewählt |
| ChatGPT | Vorausgewählt |
| Home Assistant | Vorausgewählt |
| Claude Code | Aus, weil sich auf deinem Computer auch ein anderes Programm als Claude Code ausgeben kann |
| Andere KI-Assistenten | Aus. Erlaub es nur, wenn du die Anmeldung gerade selbst gestartet hast. |
Ein eigenes Programm nimmt einen Schlüssel.
Widerrufen und Ablauf
- Widerrufen kannst du jede Verbindung unter Einstellungen, Geräte & Schlüssel. Das gilt sofort und lässt sich nicht zurücknehmen.
- Änderst du dein Passwort oder setzt es zurück, widerruft Spooly alle Verbindungen und Schlüssel deines Kontos.
- Läuft Pro ab, antwortet die API mit 403
pro_. Der Schlüssel bleibt und geht wieder, sobald Pro aktiv ist.expired - Neue Schlüssel: höchstens 30 in der Stunde je Konto. Wie viele du insgesamt hast, ist nicht begrenzt.