Rate Limits — wie oft darf ich die API fragen?
Community: 120 Entscheidungs-Anfragen/Tag pro Key. Basic ohne Key: 60/h pro IP. Professional: 600/h pro Account. Telemetry, PV und Weather haben eigene Softcaps — sie fressen nicht das Decision-Kontingent.
Was ist ein Rate Limit?
Ein Limit schützt den Dienst und andere Nutzer: niemand soll die API hundertmal pro Sekunde bombardieren.
Alltagsbeispiel: Wie „maximal 3 Anrufe pro Stunde bei der Hotline“ — bei Überschreitung kommt eine klare Absage (bei uns oft HTTP 429).
Was gilt grob?
| Art | Typische Nutzung | Hinweis |
|---|---|---|
| Fair Use / Decision | Forecast, Decision, Windows, Hours Decide | Tages-/Stundenkontingent je Tarif |
| Telemetry | SOC-/Zähler-Pings | Eigenes Softcap — frisst nicht das Decision-Kontingent |
| PV Forecast | 7-Tage-PV-Ertrag | Klasse pv — Community 48/Tag, sonst 288/Tag |
| Weather | Standortwetter | Klasse weather — Community 48/Tag, sonst 288/Tag |
Community hat ein faires Tagesbudget (orientierend: Decision-Aufrufe im Bereich von ca. 120/Tag — genaue Durchsetzung siehe Antwort/access und Portal). Professional/OEM: Stundenkontingent pro Account (nicht pro Key). Telemetry-Softcap: Community 2000/Tag, bezahlt 10000/Tag (eigene Klasse, frisst Decision nicht). PV/Weather: typisch stündlich pollen (Community 48/Tag, sonst 288/Tag).
Empfehlung fürs Smart Home
| Aktion | Takt |
|---|---|
| Forecast / Decide | stündlich oder nach Ereignis (z. B. nach 14 Uhr Day-Ahead) |
| Telemetry | alle 5–15 Minuten oder bei SOC-Stufen (50→40→30…) |
| PV Forecast / Weather | stündlich (Server-Cache 1×/Tag); Loxone-Doppel-GET wird für pv/weather innerhalb ~3 s nur einmal gezählt |
| Windows | bei Bedarf, nicht sekündlich |
EMS-Geräte pollen nicht jede Sekunde — das braucht niemand und trifft Limits.
Was tun bei 429?
1. Kurz warten (Retry-After-Header) 2. Intervall vergrößern 3. Telemetry und Decide trennen (richtige Endpoints)
Auf erfolgreichen /v1/*-Antworten und auf 429 stehen X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Scope.
Nächste Schritte
Community registrieren oder Code-Beispiele mit Ihrem persönlichen Key.