Skip to content
qr3.app Docs

Omejitev paketa

HTTP 422 Unprocessable Entity

Vaš trenutni paket ne dovoljuje tega dejanja. Sama zahteva je veljavna, vendar bi njena izvedba presegla omejitev vašega paketa. API preveri omejitve, preden karkoli zapiše, zato ni bilo nič ustvarjeno. Nadgradite svoj paket ali sprostite kapaciteto, na primer z brisanjem DPP-jev ali dinamičnih kod, ki jih več ne potrebujete.

Tipični sprožilci

  • Kvota DPP-jev: POST /v1/dpp, POST /v1/dpp/batch ali POST /v1/dpp/import bi ustvarili več DPP-jev, kot jih vključuje vaš paket. Uvoz šteje le veljavne vrstice. Veliki uvozi se izvajajo v ozadju in ob zagonu ponovno preverijo kvoto; če se je ta medtem zapolnila, se opravilo zaključi s statusom failed.
  • Dinamične kode: POST /v1/codes ali POST /v1/codes/batch bi presegli kvoto dinamičnih QR-kod vaše organizacije.
  • Velikost serije (batch): POST /v1/codes/batch vsebuje več elementov, kot jih vaš paket dovoljuje na zahtevo.
  • Vrstice za uvoz: datoteka za POST /v1/dpp/import vsebuje več vrstic s podatki, kot jih vaš paket dovoljuje na zahtevo. POST /v1/codes/import sprejme največ 1.000 vrstic v vsakem paketu.
  • Delovni prostori in člani ekipe: POST /v1/workspaces ali POST /v1/members bi presegli število delovnih prostorov (workspaces) ali članov ekipe, ki jih vključuje vaš paket.
  • Dokumenti DPP: Paket Free ne vključuje shrambe dokumentov za DPP-je, zato sta POST /v1/dpp/:id/documents in POST /v1/dpp/:id/images tam zavrnjena. Pri drugih paketih velja omejitev največjega števila dokumentov na DPP.
  • Datoteke: POST /v1/files/upload bi presegel največje število datotek na QR-kodo.
  • Register EU: POST /v1/dpp/:id/register zahteva paket Business, Agency ali Enterprise.

Odgovor

Kjer je to primerno, odgovor vsebuje razširitvena polja resource in limit: resource poimenuje omejitev (dynamic_codes, batch_size, workspaces ali team_members), limit pa je njena vrednost v vašem paketu. Pri dinamičnih kodah polje used dodatno prikazuje, koliko kod se že upošteva v kvoti.

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

Ni omejitev zahtev (rate limit)

Ponovni poskus pozneje pri tej napaki ne pomaga: omejitev ostane, dokler ne nadgradite paketa ali sprostite kapacitete. Začasne omejitve namesto tega odgovorijo s HTTP 429: rate-limited za 60 zahtev na minuto na API ključ, rate-limit pa za omejitve na ravni virov, kot je dnevno ustvarjanje kod.

← Referenca napak