Přeskočit na obsah

Limit plánu

HTTP 422 Unprocessable Entity

Váš aktuální tarif neumožňuje tuto akci. Samotný požadavek je platný, ale jeho provedení by překročilo limit vašeho tarifu. API provádí kontrolu před jakýmkoli zápisem, takže nebylo nic vytvořeno. Upgradujte svůj tarif nebo uvolněte kapacitu, například smazáním DPP nebo dynamických kódů, které již nepotřebujete.

Typické spouštěče

  • Kvóta DPP: POST /v1/dpp, POST /v1/dpp/batch nebo POST /v1/dpp/import by vytvořily více DPP, než váš tarif obsahuje. Import započítává pouze své platné řádky. Velké importy běží na pozadí a při svém spuštění znovu kontrolují kvótu; pokud se mezitím zaplnila, úloha skončí se stavem failed.
  • Dynamické kódy: POST /v1/codes nebo POST /v1/codes/batch by překročily kvótu dynamických QR kódů vaší organizace.
  • Velikost dávky: POST /v1/codes/batch obsahuje více položek, než váš tarif dovoluje na jeden požadavek.
  • Řádky importu: soubor pro POST /v1/dpp/import má více datových řádků, než váš tarif dovoluje na jeden požadavek. POST /v1/codes/import přijímá u všech tarifů nejvýše 1 000 řádků.
  • Workspaces a členové týmu: POST /v1/workspaces nebo POST /v1/members by překročily počet Workspaces nebo členů týmu, které váš tarif obsahuje.
  • Dokumenty DPP: Tarif Free neobsahuje žádné úložiště dokumentů pro DPP, proto jsou zde požadavky POST /v1/dpp/:id/documents a POST /v1/dpp/:id/images odmítnuty. U ostatních tarifů je limitem maximální počet dokumentů na jedno DPP.
  • Soubory: POST /v1/files/upload by překročil maximální počet souborů na jeden QR kód.
  • Registr EU: POST /v1/dpp/:id/register vyžaduje tarif Business, Agency nebo Enterprise.

Odpověď

V příslušných případech obsahuje odpověď rozšiřující pole resource a limit: resource označuje limit (dynamic_codes, batch_size, workspaces nebo team_members), limit je jeho hodnota ve vašem tarifu. U dynamických kódů pole used navíc ukazuje, kolik kódů se již do kvóty započítává.

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

Nejedná se o rate limit

Opakování pokusu později u této chyby nepomůže: limit trvá, dokud neprovedete upgrade nebo neuvolníte kapacitu. Dočasné limity místo toho odpovídají s HTTP 429: rate-limited pro limit 60 požadavků za minutu na jeden API klíč, rate-limit pro limity na úrovni prostředků, jako je denní vytváření kódů.

← Přehled chyb