spooly.eu/docs/limits

Grenzen

Die Grenzen fangen Automationen ab, die im Kreis laufen. Zum Vergleich: Die Home-Assistant-Integration braucht rund 1.450 Aufrufe am Tag.

Als Text öffnen

Auf dieser Seite

Werte

Grenze	Wert	Code
Aufrufe	10.000 am Tag je Konto, über alle Verbindungen zusammen. Der Tag endet um Mitternacht (UTC).	`fair_use`
Gleichzeitig	4 Anfragen je Konto. Dazu gibt es Grenzen, die alle Konten teilen: 12 Anfragen zusammen, und bei der Schlüsselprüfung 16 zusammen und 4 je IP-Adresse. Darüber antwortet die API sofort, mit Retry-After: 1.	`too_many_parallel`
Größe einer Anfrage	Höchstens 64 KB für `/api/v1` und `/api/spoolman`. Größere Anfragen lehnt Spooly mit 413 ab, ohne sie zu lesen.	kein Code, siehe Fehlercodes
Änderungen je Minute	60 je Verbindung	`change_rate_limit`
Änderungen je Tag	500 je Verbindung	`change_daily_limit`
Neue Spulen je Tag	100 je Verbindung	`new_spool_daily_limit`
Neue Schlüssel	30 in der Stunde je Konto	`too_many_keys`

Was zählt

Jede gültige Anfrage zählt als Aufruf, auch die, mit der eine KI ihre Werkzeugliste holt.
Gescheiterte Änderungen zählen nicht gegen die Änderungsgrenzen.
Den Stand von heute zeigt GET /me in calls_today und daily_limit.

Wie dein Programm reagiert

Alle Grenzen antworten mit 429. Die Wartezeit in Sekunden steht im Kopf Retry-After. Warte mindestens so lange und wiederhol dann. Bei fair_use geht es erst nach Mitternacht (UTC) weiter.

too_many_parallel kann dich auch treffen, wenn gerade andere viel anfragen, obwohl du selbst nur wenig schickst. Warte dann kurz und wiederhol die Anfrage.

Lass eine Automation nicht bei jedem Messwert schreiben. Eine Waage, die zehnmal in der Sekunde meldet, braucht eine Bedingung, die auf einen ruhigen Wert wartet.