Zum Hauptinhalt springen

quota_exceeded

HTTP 402 · code: "quota_exceeded" · type: https://docs.formfeed.dev/errors/quota-exceeded

Ein Live-Rendering, ein Batch oder ein PDF-Tool wurde abgelehnt, bevor etwas gerendert wurde, weil die Organisation in dieser Abrechnungsperiode keine Einheiten mehr dafür hat. period_end ist der Tag, an dem die nächste Periode beginnt. Test-Schlüssel werden dafür nie abgelehnt: Test-Renderings werden nicht gezählt.

Beispiel​

{
  "type": "https://docs.formfeed.dev/errors/quota-exceeded",
  "title": "Quota exceeded",
  "status": 402,
  "detail": "The free plan's 100 units for this period are used up",
  "code": "quota_exceeded",
  "period_end": "2026-11-01",
  "request_id": "req_4b7c1e9a2f3d4c5b8a6e7f9012"
}

Häufige Ursachen​

  • Der Free-Plan hat seine 100 Einheiten der Periode verbraucht. Free hat keinen Mehrverbrauch, Live-Renderings stoppen also bis zur nächsten Periode.
  • Ein bezahlter Plan hat seine Obergrenze erreicht: die enthaltenen Einheiten, die vorausbezahlten Einheiten gekaufter Pakete und Mehrverbrauch im Wert des Dreifachen des monatlichen Planpreises. Dann lautet detail Overage for this period reached the hard cap of … units, das Problem trägt hard_cap_units, und die automatische Aufstockung ist aus.
  • Ein Batch braucht mindestens eine Einheit pro Element, und es sind weniger übrig (The batch needs at least 40 units; 12 remain in this period). Vom Batch wird nichts eingereiht.

Die Periode eines bezahlten Plans läuft monatlich ab dem Tag des Abonnements, nicht nach Kalendermonat; siehe Abrechnungsperioden und Wenn die Einheiten aufgebraucht sind.

So beheben Sie es​

  • Warten Sie auf die nächste Periode (period_end), wechseln Sie den Plan oder kaufen Sie ein Einheitenpaket auf der Abrechnungsseite.
  • In einem bezahlten Plan kaufen Sie auf der Seite Abrechnung ein Prepaid-Einheitenpaket: Seine Einheiten heben die Obergrenze sofort an.
  • Entwickeln Sie mit einem Test-Schlüssel weiter: Test-Renderings werden nicht gezählt.
  • Abonnieren Sie den Webhook quota.warning, um davon zu erfahren, wenn 80 % der enthaltenen Einheiten verbraucht sind.

Wiederholen?​

Erst, wenn wieder Einheiten verfügbar sind. Senden Sie die Anfrage dann mit einem neuen Idempotency-Key oder ohne: Eine 4xx-Antwort wird 24 Stunden unter ihrem Schlüssel gespeichert, der alte Schlüssel liefert also wieder dieses Problem. Siehe Wiederholen.