limită-plan

HTTP 422 Unprocessable Entity

Planul tău curent nu permite această acțiune. Cererea în sine este validă, dar executarea ei ar depăși o limită a planului tău. API-ul verifică înainte de a scrie ceva, așa că nu a fost creat nimic. Fă upgrade la planul tău sau eliberează capacitate, de exemplu prin ștergerea DPP-urilor sau a codurilor dinamice de care nu mai ai nevoie.

Declanșatori tipici

Cotă DPP: POST /v1/dpp, POST /v1/dpp/batch sau POST /v1/dpp/import ar crea mai multe DPP-uri decât include planul tău. Un import contorizează doar rândurile sale valide. Importurile mari rulează în fundal și verifică din nou cota când încep; dacă aceasta s-a umplut între timp, jobul se termină cu statusul failed.
Coduri dinamice: POST /v1/codes sau POST /v1/codes/batch ar depăși cota de coduri QR dinamice a organizației tale.
Dimensiune lot: POST /v1/codes/batch conține mai multe elemente decât permite planul tău per cerere.
Rânduri de import: fișierul pentru POST /v1/dpp/import are mai multe rânduri de date decât permite planul tău per cerere. POST /v1/codes/import acceptă cel mult 1.000 de rânduri pe orice plan.
Spații de lucru și membri ai echipei: POST /v1/workspaces sau POST /v1/members ar depăși numărul de spații de lucru sau de membri ai echipei pe care le include planul tău.
Documente DPP: Free nu include stocare de documente pentru DPP-uri, așa că POST /v1/dpp/:id/documents și POST /v1/dpp/:id/images sunt refuzate acolo. Pe celelalte planuri, limita este numărul maxim de documente per DPP.
Fișiere: POST /v1/files/upload ar depăși numărul maxim de fișiere per cod QR.
Registrul UE: POST /v1/dpp/:id/register necesită un plan Business, Agency sau Enterprise.

Răspuns

Acolo unde se aplică, răspunsul conține câmpurile de extensie resource și limit: resource denumește limita (dynamic_codes, batch_size, workspaces sau team_members), limit este valoarea acesteia în planul tău. Pentru codurile dinamice, used arată, de asemenea, câte coduri sunt deja contorizate în cadrul cotei.

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

Nu este o limită de rată

Reîncercarea mai târziu nu ajută în cazul acestei erori: limita rămâne până când faci upgrade sau eliberezi capacitate. Limitele temporare răspund în schimb cu HTTP 429: rate-limited pentru cele 60 de cereri pe minut per cheie API, rate-limit pentru limitele la nivel de resursă, cum ar fi crearea zilnică de coduri.

← Referință erori