Optionen: Uploads, Mengen und Zugriffsbegrenzung

Alle Werte liegen unter InvoiceApi. Als Umgebungsvariable mit doppeltem Unterstrich je Ebene: InvoiceApi__MaxUploadBytes. Wo die Einstellungen hingehören, steht unter Konfiguration.

Uploads und Mengengrenzen

Option	Vorgabe	Wirkung
`MaxUploadBytes`	`15728640` (15 MB)	Obergrenze je Datei; darüber `413`. Gilt für den Webserver und die Multipart-Grenze
`SlowUploadWarnBytes`	`4194304` (4 MB)	ab dieser Größe warnt das Formular vor merklicher Wartezeit. Blockiert nie; `0` schaltet den Hinweis aus
`MaxBatchItems`	`50`	harte Obergrenze an Dateien je Stapellauf, über den Tarifgrenzen. Wirksam ist das Minimum aus beidem
`MaxBulkRows`	`5000`	harte Obergrenze an Tabellenzeilen je Massenimport
`ResultTtlMinutes`	`30`	Lebensdauer eines flüchtig gehaltenen Ergebnisses — der Ergebnisseiten nach einem Upload

Zugriffsbegrenzung

Option	Vorgabe	Wirkung
`RateLimitPermitPerWindow`	`60`	Anfragen je Fenster; darüber sofort `429`, ohne Warteschlange
`RateLimitWindowSeconds`	`60`	Länge des Fensters
`AnonToolLimitEnabled`	`true`	Stunden-/Tagesdeckel für nicht angemeldete Nutzung
`AnonToolLimitPerHour`	`20`	Werkzeug-Aufrufe je Stunde und Clientadresse
`AnonToolLimitPerDay`	`50`	Werkzeug-Aufrufe je Tag und Clientadresse
`FairUseHintThreshold`	`8`	ab so vielen Aufrufen in der laufenden Stunde erscheint der Fair-Use-Hinweis; `0` schaltet ihn aus

Wie partitioniert wird

Pro Clientadresse — außer bei /api-Aufrufen mit einem bekannten API-Schlüssel, die je Schlüssel gezählt werden. Mehrere Systeme hinter einer NAT-Adresse teilen sich damit kein Fenster.

Der Dienst prüft diese Werte beim Start

Upload-Grenze, Ergebnis-Lebensdauer, Rate-Limit-Werte und Stapelgröße müssen positiv sein. Bei Unsinn bricht der Dienst ab, statt mit unbrauchbaren Grenzen still weiterzulaufen.

Werte am Code gegengeprüft am 22.10.2026.