Csomagkorlát

HTTP 422 Unprocessable Entity

A jelenlegi csomagod nem teszi lehetővé ezt a műveletet. Maga a kérés érvényes, de a végrehajtása túllépné a csomagod egyik limitjét. Az API ellenőrzést végez, mielőtt bármit is írna, így semmi sem jött létre. Válts nagyobb csomagra (upgrade), vagy szabadíts fel kapacitást, például a már nem használt DPP-k vagy dinamikus kódok törlésével.

Tipikus kiváltó okok

• DPP-keret: A POST /v1/dpp, POST /v1/dpp/batch vagy POST /v1/dpp/import több DPP-t hozna létre, mint amennyit a csomagod tartalmaz. Az importálás csak az érvényes sorokat számolja. A nagy méretű importálások a háttérben futnak, és az induláskor újra ellenőrzik a keretet; ha az időközben betelt, a folyamat failed státusszal zárul.
• Dinamikus kódok: A POST /v1/codes vagy POST /v1/codes/batch túllépné a szervezeted dinamikus QR-kód keretét.
• Batch-méret: A POST /v1/codes/batch több elemet tartalmaz, mint amennyit a csomagod kérésenként megenged.
• Importálási sorok: A POST /v1/dpp/import fájlja több adatsort tartalmaz, mint amennyit a csomagod kérésenként megenged. A POST /v1/codes/import minden csomagban legfeljebb 1000 sort fogad el.
• Workspace-ek és csapattagok: A POST /v1/workspaces vagy POST /v1/members túllépné a csomagodban foglalt Workspace-ek vagy csapattagok számát.
• DPP-dokumentumok: A Free csomag nem tartalmaz dokumentumtárhelyet a DPP-khez, így a POST /v1/dpp/:id/documents és POST /v1/dpp/:id/images ott elutasításra kerül. A többi csomagban a DPP-nkénti dokumentumok maximális száma jelenti a korlátot.
• Fájlok: A POST /v1/files/upload túllépné a QR-kódonkénti fájlok maximális számát.
• EU-regiszter: A POST /v1/dpp/:id/register használatához Business, Agency vagy Enterprise csomag szükséges.

Válasz

Ahol értelmezhető, a válasz tartalmazza a resource és limit kiterjesztési mezőket: a resource megnevezi a limitet (dynamic_codes, batch_size, workspaces vagy team_members), a limit pedig annak értékét mutatja a csomagodban. Dinamikus kódok esetén a used azt is jelzi, hogy hány kód számít már bele a keretbe.

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

Ez nem sebességkorlát (rate limit)

Későbbi újrapróbálkozás nem segít ezen a hibán: a limit érvényben marad, amíg nem váltasz nagyobb csomagra, vagy nem szabadítasz fel kapacitást. Az átmeneti korlátozások ehelyett HTTP 429 választ adnak: rate-limited az API-kulcsonkénti percenkénti 60 kérésre, és rate-limit az erőforrás-szintű korlátokra, mint például a napi kódlétrehozás.

← Hiba-referencia