Salta ai contenuti
qr3.app Docs

limite-piano

HTTP 422 Unprocessable Entity

Il tuo piano attuale non consente questa azione. La richiesta in sé è valida, ma la sua esecuzione supererebbe un limite del tuo piano. L’API effettua una verifica prima di scrivere qualsiasi dato, quindi non è stato creato nulla. Effettua l’upgrade del tuo piano o libera spazio, ad esempio eliminando i DPP o i codici dinamici che non ti servono più.

Cause tipiche

  • Quota DPP: POST /v1/dpp, POST /v1/dpp/batch o POST /v1/dpp/import creerebbero più DPP di quanti ne includa il tuo piano. Un’importazione conta solo le sue righe valide. Le importazioni di grandi dimensioni vengono eseguite in background e verificano nuovamente la quota al loro avvio; se nel frattempo questa si è esaurita, il job termina con lo stato failed.
  • Codici dinamici: POST /v1/codes o POST /v1/codes/batch supererebbero la quota di codici QR dinamici della tua organizzazione.
  • Dimensione del batch: POST /v1/codes/batch contiene più elementi di quanti il tuo piano ne consenta per singola richiesta.
  • Righe di importazione: il file per POST /v1/dpp/import contiene più righe di dati di quante il tuo piano ne consenta per singola richiesta. POST /v1/codes/import accetta al massimo 1.000 righe su qualsiasi piano.
  • Workspace e membri del team: POST /v1/workspaces o POST /v1/members supererebbero il numero di workspace o di membri del team inclusi nel tuo piano.
  • Documenti DPP: il piano Free non include spazio di archiviazione per i documenti dei DPP, pertanto POST /v1/dpp/:id/documents e POST /v1/dpp/:id/images vengono rifiutati. Negli altri piani, il limite è rappresentato dal numero massimo di documenti per DPP.
  • File: POST /v1/files/upload supererebbe il numero massimo di file per codice QR.
  • Registro UE: POST /v1/dpp/:id/register richiede un piano Business, Agency o Enterprise.

Risposta

Laddove applicabile, la risposta contiene i campi di estensione resource e limit: resource indica il limite interessato (dynamic_codes, batch_size, workspaces o team_members), limit è il suo valore nel tuo piano. Per i codici dinamici, il campo used mostra inoltre quanti codici sono già conteggiati nella quota.

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

Non è un rate limit

Riprovare più tardi non risolverà questo errore: il limite rimane attivo finché non effettui un upgrade o liberi spazio. I limiti temporanei rispondono invece con HTTP 429: rate-limited per il limite di 60 richieste al minuto per chiave API, rate-limit per i limiti a livello di risorsa, come la creazione giornaliera di codici.

← Riferimento errori