Hoppa till innehåll
qr3.app Docs

plan-limit

HTTP 422 Unprocessable Entity

Din nuvarande plan tillåter inte denna åtgärd. Själva begäran är giltig, men att utföra den skulle överskrida en gräns för din plan. API:et kontrollerar detta innan något skrivs, så ingenting har skapats. Uppgradera din plan eller frigör kapacitet, till exempel genom att ta bort DPP:er eller dynamiska koder som du inte längre behöver.

Typiska utlösare

  • DPP-kvot: POST /v1/dpp, POST /v1/dpp/batch eller POST /v1/dpp/import skulle skapa fler DPP:er än vad din plan innehåller. En import räknar endast sina giltiga rader. Stora importer körs i bakgrunden och kontrollerar kvoten igen när de startar; om den har fyllts under tiden avslutas jobbet med status failed.
  • Dynamiska koder: POST /v1/codes eller POST /v1/codes/batch skulle överskrida din organisations kvot för dynamiska QR-koder.
  • Batch-storlek: POST /v1/codes/batch innehåller fler objekt än vad din plan tillåter per begäran.
  • Importrader: filen för POST /v1/dpp/import har fler datarader än vad din plan tillåter per begäran. POST /v1/codes/import accepterar som mest 1 000 rader på alla planer.
  • Workspaces och teammedlemmar: POST /v1/workspaces eller POST /v1/members skulle överskrida antalet workspaces eller teammedlemmar som ingår i din plan.
  • DPP-dokument: Free innehåller inget dokumentutrymme för DPP:er, så POST /v1/dpp/:id/documents och POST /v1/dpp/:id/images avvisas där. På de andra planerna är gränsen det maximala antalet dokument per DPP.
  • Filer: POST /v1/files/upload skulle överskrida det maximala antalet filer per QR-kod.
  • EU-register: POST /v1/dpp/:id/register kräver en Business-, Agency- eller Enterprise-plan.

Svar

Där det är tillämpligt innehåller svaret fälten resource och limit: resource anger gränsen (dynamic_codes, batch_size, workspaces eller team_members), limit är dess värde på din plan. För dynamiska koder visar used dessutom hur många koder som redan räknas mot kvoten.

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

Inte en rate-limit

Att försöka igen senare hjälper inte mot detta fel: gränsen kvarstår tills du uppgraderar eller frigör kapacitet. Tillfälliga gränser svarar istället med HTTP 429: rate-limited för de 60 begärandena per minut per API-nyckel, rate-limit för gränser på resursnivå såsom dagligt skapande av koder.

← Felreferens