Ga naar inhoud
qr3.app Docs

plan-limit

HTTP 422 Unprocessable Entity

Je huidige plan staat deze actie niet toe. De aanvraag zelf is geldig, maar de uitvoering ervan zou een limiet van je plan overschrijden. De API controleert dit voordat er iets wordt weggeschreven, dus er is niets aangemaakt. Upgrade je plan of maak capaciteit vrij, bijvoorbeeld door DPP’s of dynamische codes die je niet meer nodig hebt te verwijderen.

Typische triggers

  • DPP-quotum: POST /v1/dpp, POST /v1/dpp/batch of POST /v1/dpp/import zou meer DPP’s aanmaken dan in je plan zijn inbegrepen. Een import telt alleen de geldige rijen. Grote imports worden op de achtergrond uitgevoerd en controleren het quotum opnieuw wanneer ze starten; als dit in de tussentijd vol is geraakt, eindigt de taak met de status failed.
  • Dynamische codes: POST /v1/codes of POST /v1/codes/batch zou het quotum van je organisatie voor dynamische QR-codes overschrijden.
  • Batchgrootte: POST /v1/codes/batch bevat meer items dan je plan per aanvraag toestaat.
  • Importrijen: het bestand voor POST /v1/dpp/import heeft meer datarijen dan je plan per aanvraag toestaat. POST /v1/codes/import accepteert maximaal 1.000 rijen in elk plan.
  • Workspaces en teamleden: POST /v1/workspaces of POST /v1/members zou het aantal workspaces of teamleden overschrijden dat in je plan is inbegrepen.
  • DPP-documenten: Free bevat geen documentopslag voor DPP’s, dus POST /v1/dpp/:id/documents en POST /v1/dpp/:id/images worden daar geweigerd. In de andere plannen geldt de limiet voor het maximale aantal documenten per DPP.
  • Bestanden: POST /v1/files/upload zou het maximale aantal bestanden per QR-code overschrijden.
  • EU-register: POST /v1/dpp/:id/register vereist een Business-, Agency- of Enterprise-plan.

Respons

Waar van toepassing bevat de respons de uitbreidingsvelden resource en limit: resource noemt de limiet (dynamic_codes, batch_size, workspaces of team_members), limit is de waarde ervan in je plan. Bij dynamische codes laat used bovendien zien hoeveel codes er al meetellen voor het quotum.

{
  "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
}

Geen rate-limit

Later opnieuw proberen helpt niet bij deze fout: de limiet blijft van kracht totdat je upgradet of capaciteit vrijmaakt. Tijdelijke limieten antwoorden in plaats daarvan met HTTP 429: rate-limited voor de 60 aanvragen per minuut per API-key, rate-limit voor limieten op bronniveau, zoals het dagelijks aanmaken van codes.

← Foutreferentie