Skip to content
qr3.app Docs

Ograničenje plana

HTTP 422 Unprocessable Entity

Vaš trenutni plan ne dopušta ovu akciju. Sam zahtjev je valjan, ali bi njegovo izvršenje premašilo ograničenje vašeg plana. API provjerava stanje prije nego što bilo što zapiše, tako da ništa nije stvoreno. Nadogradite svoj plan ili oslobodite kapacitet, primjerice brisanjem DPP-ova ili dinamičkih kodova koje više ne trebate.

Tipični uzročnici

  • DPP kvota: POST /v1/dpp, POST /v1/dpp/batch ili POST /v1/dpp/import stvorili bi više DPP-ova nego što vaš plan uključuje. Uvoz broji samo svoje valjane retke. Veliki uvozi rade u pozadini i ponovno provjeravaju kvotu kada započnu; ako se ona u međuvremenu popunila, zadatak završava sa statusom failed.
  • Dinamički kodovi: POST /v1/codes ili POST /v1/codes/batch premašili bi kvotu dinamičkih QR kodova vaše organizacije.
  • Veličina serije: POST /v1/codes/batch sadrži više stavki nego što vaš plan dopušta po zahtjevu.
  • Retci za uvoz: datoteka za POST /v1/dpp/import ima više redaka s podacima nego što vaš plan dopušta po zahtjevu. POST /v1/codes/import prihvaća najviše 1.000 redaka na svakom planu.
  • Radni prostori i članovi tima: POST /v1/workspaces ili POST /v1/members premašili bi broj radnih prostora ili članova tima koje vaš plan uključuje.
  • DPP dokumenti: Free ne uključuje pohranu dokumenata za DPP-ove, pa se POST /v1/dpp/:id/documents i POST /v1/dpp/:id/images tamo odbijaju. Na ostalim planovima ograničenje je maksimalni broj dokumenata po DPP-u.
  • Datoteke: POST /v1/files/upload premašio bi maksimalni broj datoteka po QR kodu.
  • EU registar: POST /v1/dpp/:id/register zahtijeva plan Business, Agency ili Enterprise.

Odgovor

Tamo gdje je primjenjivo, odgovor sadrži proširena polja resource i limit: resource imenuje ograničenje (dynamic_codes, batch_size, workspaces ili team_members), a limit je njegova vrijednost u vašem planu. Za dinamičke kodove, used dodatno prikazuje koliko se kodova već ubraja u kvotu.

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

Nije ograničenje učestalosti

Ponovni pokušaj kasnije ne pomaže kod ove pogreške: ograničenje ostaje sve dok ne nadogradite plan ili oslobodite kapacitet. Privremena ograničenja umjesto toga odgovaraju s HTTP 429: rate-limited za 60 zahtjeva u minuti po API ključu, rate-limit za ograničenja na razini resursa kao što je dnevno stvaranje kodova.

← Referenca pogrešaka