API-Limits

Diese Seite richtet sich an Seitenbetreiber. Besuchte Wetterdaten werden geteilt und cache-freundlich gehalten, damit OpenWeather-Free-Tier-Limits (Standard 1000 Aufrufe/Tag) seltener verbrannt werden.

Defaults aus constants/weather.js: DAILY_LIMIT 1000, WARNING_THRESHOLD 800, SOFT_BLOCK_THRESHOLD 950, PER_MINUTE_LIMIT 60 Upstream-Aufrufe pro rollierender Minute. platform_settings kann daily_limit, soft_block_threshold, warning_threshold und per_minute_limit überschreiben (Defaults beim ersten DB-Öffnen gesät). Zähler setzt um UTC-Mitternacht zurück.

ok — unter Warnschwelle. warning — bei oder über warning_threshold (Standard 800 Aufrufe heute). soft_block — bei oder über soft_block_threshold (Standard 950); Upstream blockiert. hard_block — bei daily_limit (Standard 1000). Minuten-Obergrenze blockiert Upstream ebenfalls, wenn per_minute_limit Aufrufe in den letzten 60 Sekunden stattfanden.

L2-Datenbank-Hits loggen in api_call_log mit cache_hit=1 und erhöhen den täglichen Upstream-Zähler nicht. L1-Speicher-Hits werden nicht in SQLite geloggt — recordCacheHit kehrt früh zurück, wenn meta.layer memory ist. Nur erfolgreiche Upstream-OpenWeather-Aufrufe (Status 200, cache_hit=0) zählen zur Quota. Emergency-stale liefert ohne Upstream, wenn blockiert.

Öffnen Sie /admin (nach Anmeldung) für heute genutzt / Tageslimit, verbleibend, Status und Aktualisierungsintervall-Einstellungen. API: GET /api/admin/usage.

GET /api/admin/usage — Quota-Snapshot und letzte Aufrufe. GET|PATCH /api/admin/config — primäre Admin-Einstellungs-API (Aktualisierungsintervall, Connectors, Digest-Defaults, AdSense, Warnungs-Toggles usw.). Schmales Legacy: PATCH /api/admin/settings { refreshIntervalMs }. Auth: HttpOnly-Session-Cookie meridian_admin_session nach /login. Signatur-Geheimnis ist ADMIN_SECRET (nicht ADMIN_PASSWORD). Dev-Bypass bei NODE_ENV=development, ALLOW_DEV_ADMIN_BYPASS=1 und ADMIN_SECRET unset.

meridian trackt seinen eigenen Upstream-Zähler; OpenWeather kann Schlüssel unabhängig rate-limiten oder ablehnen (401, 429). Der Orchestrator mappt diese auf strukturierte API-Fehler für den Client.

Bei soft/hard block sehen Nutzer weiterhin den letzten akzeptablen SQLite-Snapshot mit freshness emergency statt eines leeren Fehlers — außer es gab nie einen Snapshot für diese Koordinate.