Skip to content
qr3.app Docs

Лимит на плана

HTTP 422 Unprocessable Entity

Текущият ви план не позволява това действие. Самата заявка е валидна, но изпълнението ѝ би надвишило лимита на вашия план. API извършва проверка преди запис, така че нищо не е създадено. Надградете плана си или освободете капацитет, например като изтриете DPP или динамични кодове, които вече не са ви необходими.

Типични причини

  • Квота за DPP: POST /v1/dpp, POST /v1/dpp/batch или POST /v1/dpp/import биха създали повече DPP, отколкото включва вашият план. При импортиране се броят само валидните редове. Големите импортирания се изпълняват във фонов режим и проверяват квотата отново при стартирането си; ако междувременно тя се е запълнила, задачата завършва със статус failed.
  • Динамични кодове: POST /v1/codes или POST /v1/codes/batch биха надвишили квотата за динамични QR кодове на вашата организация.
  • Размер на партидата: POST /v1/codes/batch съдържа повече елементи, отколкото вашият план позволява за една заявка.
  • Редове за импортиране: файлът за POST /v1/dpp/import съдържа повече редове с данни, отколкото вашият план позволява за една заявка. POST /v1/codes/import приема най-много 1 000 реда при всеки план.
  • Работни пространства и членове на екипа: POST /v1/workspaces или POST /v1/members биха надвишили броя на работните пространства (Workspaces) или членовете на екипа, включени във вашия план.
  • Документи за DPP: Планът Free не включва съхранение на документи за DPP, поради което POST /v1/dpp/:id/documents и POST /v1/dpp/:id/images се отхвърлят там. При останалите планове лимитът е максималният брой документи за едно DPP.
  • Файлове: POST /v1/files/upload би надвишил максималния брой файлове за един QR код.
  • Регистър на ЕС: POST /v1/dpp/:id/register изисква план Business, Agency или Enterprise.

Отговор

Където е приложимо, отговорът съдържа разширенията resource и limit: resource посочва лимита (dynamic_codes, batch_size, workspaces или team_members), а limit е неговата стойност във вашия план. При динамичните кодове used показва допълнително колко кода вече се отчитат към квотата.

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

Това не е ограничение на честотата (rate limit)

Повторният опит по-късно няма да помогне при тази грешка: лимитът остава, докато не надградите плана си или не освободите капацитет. Временните ограничения отговарят вместо това с HTTP 429: rate-limited за лимита от 60 заявки в минута за API ключ, rate-limit за ограничения на ниво ресурс, като например ежедневното създаване на кодове.

← Справка за грешки