Limits

Rate-Limits

Limit	Dauerrate	Burst
pro API-Key	10 Requests/s	20
pro Benutzer (über alle seine Keys)	20 Requests/s	40

Burst heisst: Nach einer Pause sind so viele Requests am Stück möglich, danach gilt die Dauerrate. Mehrere Keys erhöhen den Durchsatz höchstens bis zum Benutzer-Limit von 20 Requests/s, weil es alle Keys zusammenzählt.

Bei Überschreitung antwortet die API mit 429 rate_limited und dem Header Retry-After (Sekunden). Warte mindestens so lange und wiederhole dann den Request. Bei POST mit demselben Idempotency-Key.

Dokumente und Dateien

Limit	Wert	Fehler
Dateigrösse	25 MB	413 payload_too_large
Dateitypen	PDF, DOCX	422 validation_error
Signer pro Dokument	5	422 validation_error
aktive (nicht archivierte) Dokumente pro Benutzer	500	409 conflict
Signierfrist (expiry_days)	1–365 Tage	422 validation_error
API-Entwürfe und gescheiterte API-Dokumente ohne Änderung	werden nach 7 Tagen gelöscht
Test-Dokumente pro Benutzer und Tag	50	429 rate_limited, siehe Test-Modus

Archivierte Dokumente zählen nicht zu den 500 aktiven. Wenn du an die Grenze kommst, lösche erledigte Dokumente, die du nicht mehr in ratum brauchst.

API-Zugang gibt es nur in bezahlten Tarifen, abgerechnet pro versendetem Dokument. Ein festes Dokument-Kontingent gibt es dort nicht; 402 quota_exceeded ist per API-Key derzeit nicht erreichbar und für künftige Tarife reserviert.

Geplant

Zusätzlich ist eine Obergrenze von 1 000 neu angelegten Dokumenten pro Benutzer und Tag vorgesehen.