Preskočiť na obsah
qr3.app Docs

plan-limit

HTTP 422 Unprocessable Entity

Váš aktuálny program neumožňuje túto akciu. Samotná požiadavka je platná, ale jej vykonanie by prekročilo limit vášho programu. API kontroluje limity pred akýmkoľvek zápisom, takže sa nič nevytvorilo. Prejdite na vyšší program alebo uvoľnite kapacitu, napríklad vymazaním DPP alebo dynamických kódov, ktoré už nepotrebujete.

Typické spúšťače

  • Kvóta DPP: POST /v1/dpp, POST /v1/dpp/batch alebo POST /v1/dpp/import by vytvorili viac DPP, než zahŕňa váš program. Import započítava iba svoje platné riadky. Veľké importy bežia na pozadí a pri svojom spustení opäť kontrolujú kvótu; ak sa medzitým zaplnila, úloha skončí so stavom failed.
  • Dynamické kódy: POST /v1/codes alebo POST /v1/codes/batch by prekročili kvótu dynamických QR kódov vašej organizácie.
  • Veľkosť dávky: POST /v1/codes/batch obsahuje viac položiek, než váš program povoľuje na jednu požiadavku.
  • Riadky importu: súbor pre POST /v1/dpp/import má viac dátových riadkov, než váš program povoľuje na jednu požiadavku. POST /v1/codes/import akceptuje maximálne 1 000 riadkov v každom programe.
  • Workspaces a členovia tímu: POST /v1/workspaces alebo POST /v1/members by prekročili počet workspaces alebo členov tímu, ktoré váš program zahŕňa.
  • Dokumenty DPP: Program Free neobsahuje žiadne úložisko dokumentov pre DPP, preto sú tu požiadavky POST /v1/dpp/:id/documents a POST /v1/dpp/:id/images odmietnuté. V ostatných programoch platí limit na maximálny počet dokumentov na jedno DPP.
  • Súbory: POST /v1/files/upload by prekročil maximálny počet súborov na jeden QR kód.
  • Register EÚ: POST /v1/dpp/:id/register vyžaduje program Business, Agency alebo Enterprise.

Odpoveď

Ak je to relevantné, obsahuje odpoveď rozširujúce polia resource a limit: resource pomenúva limit (dynamic_codes, batch_size, workspaces alebo team_members), limit je jeho hodnota vo vašom programe. Pri dynamických kódoch pole used navyše ukazuje, koľko kódov sa už započítava do kvóty.

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

Nejde o rate-limit

Neskorší pokus pri tejto chybe nepomôže: limit pretrváva, kým neprejdete na vyšší program alebo neuvoľníte kapacitu. Dočasné limity namiesto toho odpovedajú s HTTP 429: rate-limited pre limit 60 požiadaviek za minútu na jeden API kľúč, rate-limit pre limity na úrovni prostriedkov, ako je napríklad denné vytváranie kódov.

← Referencia chýb