plan-limit

HTTP 422 Unprocessable Entity

Dein aktueller Tarif erlaubt diese Aktion nicht. Die Anfrage selbst ist gültig, ihre Ausführung würde aber ein Limit deines Tarifs überschreiten. Die API prüft, bevor sie etwas schreibt, es wurde also nichts angelegt. Wechsle auf einen höheren Tarif oder schaffe Platz, etwa indem du nicht mehr benötigte DPPs oder dynamische Codes löschst.

Typische Auslöser

DPP-Kontingent: POST /v1/dpp, POST /v1/dpp/batch oder POST /v1/dpp/import würden mehr DPPs anlegen, als dein Tarif enthält. Ein Import zählt nur seine gültigen Zeilen. Große Importe laufen im Hintergrund und prüfen das Kontingent beim Start erneut; ist es inzwischen voll, endet der Job mit dem Status failed.
Dynamische Codes: POST /v1/codes oder POST /v1/codes/batch würden das Kontingent deiner Organisation an dynamischen QR-Codes überschreiten.
Batch-Größe: POST /v1/codes/batch enthält mehr Einträge, als dein Tarif pro Anfrage erlaubt.
Importzeilen: Die Datei für POST /v1/dpp/import hat mehr Datenzeilen, als dein Tarif pro Anfrage erlaubt. POST /v1/codes/import nimmt in jedem Tarif höchstens 1.000 Zeilen an.
Workspaces und Teammitglieder: POST /v1/workspaces oder POST /v1/members würden die Zahl der Workspaces oder Teammitglieder überschreiten, die dein Tarif enthält.
DPP-Dokumente: Free enthält keinen Dokumentenspeicher für DPPs, deshalb werden POST /v1/dpp/:id/documents und POST /v1/dpp/:id/images dort abgelehnt. In den anderen Tarifen greift die Höchstzahl an Dokumenten pro DPP.
Dateien: POST /v1/files/upload würde die Höchstzahl an Dateien pro QR-Code überschreiten.
EU-Register: POST /v1/dpp/:id/register setzt einen Business-, Agency- oder Enterprise-Tarif voraus.

Antwort

Wo es zutrifft, enthält die Antwort die Erweiterungsfelder resource und limit: resource nennt das Limit (dynamic_codes, batch_size, workspaces oder team_members), limit seinen Wert in deinem Tarif. Bei dynamischen Codes zeigt used zusätzlich, wie viele Codes bereits auf das Kontingent angerechnet werden.

{
  "type": "https://docs.qr3.app/errors/plan-limit",
  "title": "Plan Limit Reached",
  "status": 422,
  "detail": "Your plan allows a maximum of 25 dynamic QR code(s). Upgrade to create more.",
  "resource": "dynamic_codes",
  "limit": 25,
  "used": 25
}

Kein Rate-Limit

Ein späterer Versuch hilft bei diesem Fehler nicht: Das Limit bleibt, bis du den Tarif wechselst oder Platz schaffst. Vorübergehende Limits antworten stattdessen mit HTTP 429: rate-limited für die 60 Anfragen pro Minute je API-Key, rate-limit für ressourcenbezogene Limits wie die tägliche Code-Erstellung.

← Fehler-Referenz