Skip to content
qr3.app Docs

Paketi limiit

HTTP 422 Unprocessable Entity

Sinu praegune pakett ei luba seda toimingut. Päring ise on kehtiv, kuid selle täitmine ületaks sinu paketi limiidi. API teeb kontrolli enne kirjutamist, seega midagi ei loodud. Uuenda oma paketti või vabasta mahtu, näiteks kustutades DPP-sid või dünaamilisi koode, mida sa enam ei vaja.

Tüüpilised põhjused

  • DPP limiit: POST /v1/dpp, POST /v1/dpp/batch või POST /v1/dpp/import püüab luua rohkem DPP-sid, kui sinu pakett sisaldab. Importimisel võetakse arvesse ainult kehtivad read. Suured impordid käivitatakse taustal ja nad kontrollivad limiiti uuesti käivitumisel; kui see on vahepeal täis saanud, lõpeb toiming staatusega failed.
  • Dünaamilised koodid: POST /v1/codes või POST /v1/codes/batch ületaks sinu organisatsiooni dünaamiliste QR-koodide limiidi.
  • Hulgipäringu suurus: POST /v1/codes/batch sisaldab rohkem kirjeid, kui sinu pakett päringu kohta lubab.
  • Impordi read: POST /v1/dpp/import jaoks mõeldud failis on rohkem andmeridu, kui sinu pakett päringu kohta lubab. POST /v1/codes/import aktsepteerib igas paketis maksimaalselt 1 000 rida.
  • Tööruumid ja meeskonnaliikmed: POST /v1/workspaces või POST /v1/members ületaks sinu paketis sisalduvate tööruumide või meeskonnaliikmete arvu.
  • DPP dokumendid: Free pakett ei sisalda DPP-de jaoks dokumendihoidlat, seega on POST /v1/dpp/:id/documents ja POST /v1/dpp/:id/images seal keelatud. Teiste pakettide puhul on piiranguks maksimaalne dokumentide arv ühe DPP kohta.
  • Failid: POST /v1/files/upload ületaks maksimaalse failide arvu ühe QR-koodi kohta.
  • EL-i register: POST /v1/dpp/:id/register nõuab Business, Agency või Enterprise paketti.

Vastus

Kui see on asjakohane, sisaldab vastus laiendusvälju resource ja limit: resource nimetab limiidi (dynamic_codes, batch_size, workspaces või team_members), limit on selle väärtus sinu paketis. Dünaamiliste koodide puhul näitab used lisaks, kui palju koode juba limiidi arvestuses kasutusel on.

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

Tegemist pole päringupiiranguga

Hiljem uuesti proovimine selle vea puhul ei aita: limiit jääb kehtima seni, kuni uuendad paketti või vabastad mahtu. Ajutised piirangud vastavad selle asemel koodiga HTTP 429: rate-limited API-võtme minutilise limiidi (60 päringut minutis) puhul, rate-limit ressursipõhiste limiitide puhul, nagu igapäevane koodide loomine.

← Vigade viited