Skip to content
qr3.app Docs

plan-limit

HTTP 422 Unprocessable Entity

Nykyinen tilauksesi ei salli tätä toimintoa. Itse pyyntö on kelvollinen, mutta sen suorittaminen ylittäisi tilauksesi rajan. API tekee tarkistuksen ennen kuin se kirjoittaa mitään, joten mitään ei ole luotu. Päivitä tilauksesi tai vapauta kiintiötä esimerkiksi poistamalla DPP-passeja tai dynaamisia koodeja, joita et enää tarvitse.

Tyypilliset syyt

  • DPP-kiintiö: POST /v1/dpp, POST /v1/dpp/batch tai POST /v1/dpp/import loisi enemmän DPP-passeja kuin tilauksesi sisältää. Tuonti laskee vain sen kelvolliset rivit. Suuret tuonnit suoritetaan taustalla, ja ne tarkistavat kiintiön uudelleen käynnistyessään; jos se on sillä välin täyttynyt, ajo päättyy tilaan failed.
  • Dynaamiset koodit: POST /v1/codes tai POST /v1/codes/batch ylittäisi organisaatiosi dynaamisten QR-koodien kiintiön.
  • Eräkoko: POST /v1/codes/batch sisältää enemmän kohteita kuin tilauksesi sallii pyyntöä kohden.
  • Tuontirivit: tiedostossa kohteelle POST /v1/dpp/import on enemmän datarivejä kuin tilauksesi sallii pyyntöä kohden. POST /v1/codes/import hyväksyy enintään 1 000 riviä kaikissa tilauksissa.
  • Työtilat ja tiimin jäsenet: POST /v1/workspaces tai POST /v1/members ylittäisi niiden työtilojen tai tiimin jäsenten määrän, jotka tilauksesi sisältää.
  • DPP-dokumentit: Free ei sisällä dokumenttitilaa DPP-passeille, joten POST /v1/dpp/:id/documents ja POST /v1/dpp/:id/images hylätään siinä. Muissa tilauksissa rajana on dokumenttien enimmäismäärä DPP-passia kohden.
  • Tiedostot: POST /v1/files/upload ylittäisi tiedostojen enimmäismäärän QR-koodia kohden.
  • EU-rekisteri: POST /v1/dpp/:id/register vaatii Business-, Agency- tai Enterprise-tilauksen.

Vastaus

Silloin kun se on sovellettavissa, vastaus sisältää laajennuskentät resource ja limit: resource nimeää rajan (dynamic_codes, batch_size, workspaces tai team_members), limit on sen arvo tilauksessasi. Dynaamisten koodien kohdalla used näyttää lisäksi, kuinka monta koodia lasketaan jo mukaan kiintiöön.

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

Kyseessä ei ole rate-limit

Yrittäminen uudelleen myöhemmin ei auta tässä virheessä: raja pysyy voimassa, kunnes päivität tilauksesi tai vapautat kiintiötä. Väliaikaiset rajat vastaavat sen sijaan HTTP 429 -virheellä: rate-limited API-avaimen 60 pyynnölle minuuttia kohden, rate-limit resurssitason rajoituksille, kuten päivittäiselle koodien luonnille.

← Virheviitteet