Skip to content
qr3.app Docs

Plano limitas

HTTP 422 Unprocessable Entity

Dabartinis jūsų planas neleidžia atlikti šio veiksmo. Pati užklausa yra teisinga, tačiau ją įvykdžius būtų viršytas jūsų plano limitas. API atlieka patikrą prieš ką nors įrašydama, todėl nieko nebuvo sukurta. Atnaujinkite savo planą arba atlaisvinkite vietos, pavyzdžiui, ištrindami DPP arba dinaminius kodus, kurių jums nebereikia.

Tipiniai atvejai

  • DPP kvota: POST /v1/dpp, POST /v1/dpp/batch arba POST /v1/dpp/import sukurtų daugiau DPP, nei numatyta jūsų plane. Importuojant skaičiuojamos tik teisingos eilutės. Dideli importai vykdomi fone ir pradžioje iš naujo patikrina kvotą; jei per tą laiką ji užsipildė, užduotis baigiama su būsena failed.
  • Dinaminiai kodai: POST /v1/codes arba POST /v1/codes/batch viršytų jūsų organizacijos dinaminių QR kodų kvotą.
  • Paketo dydis: POST /v1/codes/batch turi daugiau elementų, nei jūsų planas leidžia vienoje užklausoje.
  • Importo eilutės: failas, skirtas POST /v1/dpp/import, turi daugiau duomenų eilučių, nei jūsų planas leidžia vienoje užklausoje. POST /v1/codes/import priima ne daugiau kaip 1 000 eilučių bet kuriame plane.
  • Darbo sritys ir komandos nariai: POST /v1/workspaces arba POST /v1/members viršytų jūsų plane numatytą darbo sričių (Workspaces) arba komandos narių skaičių.
  • DPP dokumentai: Free planas neapima dokumentų saugyklos DPP, todėl POST /v1/dpp/:id/documents ir POST /v1/dpp/:id/images jame yra atmetami. Kituose planuose taikomas maksimalus dokumentų skaičius vienam DPP.
  • Failai: POST /v1/files/upload viršytų maksimalų failų skaičių vienam QR kodui.
  • ES registras: POST /v1/dpp/:id/register reikalauja Business, Agency arba Enterprise plano.

Atsakymas

Kai taikoma, atsakyme pateikiami papildomi laukai resource ir limit: resource nurodo limitą (dynamic_codes, batch_size, workspaces arba team_members), o limit – jo reikšmę jūsų plane. Dinaminių kodų atveju used papildomai rodo, kiek kodų jau yra įskaičiuota į kvotą.

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

Tai nėra užklausų ribojimas

Bandymas vėliau šios klaidos neišspręs: limitas išliks, kol neatnaujinsite plano arba neatlaisvinsite vietos. Laikinų limitų atveju grąžinamas HTTP 429 atsakymas: rate-limited dėl 60 užklausų per minutę vienam API raktui limitavimo arba rate-limit dėl išteklių lygio limitų, pavyzdžiui, kasdienio kodų kūrimo.

← Klaidų žinynas