Limits und Größen

Damit die Plattform stabil bleibt, gelten für die API Einschränkungen hinsichtlich der Anfragehäufigkeit und der Größe übertragener Daten.

Anfragehäufigkeit

Bei Überschreitung der zulässigen Anfragehäufigkeit antwortet der Server mit dem Code 429 Too Many Requests. Die richtige Reaktion ist eine Wiederholung mit exponentiellem Backoff: Verlängern Sie die Pausen zwischen Wiederholungen und senden Sie keine Anfragen in dichter Folge. Verteilen Sie Massenoperationen zeitlich und verwenden Sie einen Token sequenziell, nicht in parallelen Bursts.

Größe des Anfrage-Bodys

Für normale REST-Anfragen ist die Größe des JSON-Bodys auf 2 MiB begrenzt. Das reicht für alle Reaktionskonfigurationen, Sammlungen und Einstellungen. Wenn der Body größer ist — teilen Sie die Operation auf (z. B. Reaktionen in Batches importieren).

Body-Größe beim Import

Import-Endpunkte sind für große Bundles ausgelegt und haben eigene, höhere Limits: bis zu 64 MiB für Daten-Import und bis zu 256 MiB für Import mit eingebetteten Medien. Wenn das Bundle größer ist — teilen Sie es in mehrere Imports auf.

Limits überschreiten

  • Häufigkeitslimit überschritten — 429, Wiederholung mit Verzögerung.
  • Body größer als erlaubt — Anfrage wird abgelehnt (413 oder 400 je nach Endpunkt); reduzieren oder teilen Sie die Nutzlast auf.

Nächste Schritte