MostlyQR

Errori

L’API REST utilizza codici di stato HTTP standard e restituisce un corpo di errore JSON:

json
{ "error": "unauthorized", "message": "Missing or invalid API key" }

# Codici di stato

Stato error Quando
400 invalid-argument Corpo malformato o campo obbligatorio mancante.
401 unauthorized Chiave API mancante, non valida o revocata.
403 forbidden / failed-precondition Oltre i diritti del tuo piano (ad es. creazione di codici serializzati senza Enterprise, o superamento di una quota). Il limite è nel messaggio.
404 not-found Nessun link/campagna/job con quell’id, o non posseduto dal tuo account.
429 rate-limited Limite di velocità per chiave superato — riprova più tardi.
5xx internal Qualcosa è andato storto da parte nostra; sicuro da ritentare per letture idempotenti.

# Proprietà

Ogni lettura e scrittura è limitata all’account a cui si risolve la chiave API. La richiesta del link o della campagna di un altro account restituisce 404 (non 403) — non riveliamo che esiste.

# Job asincroni

I job di batch e serialized mint accettano la richiesta (200, queued), quindi mostrano gli errori nello stato del job (status: "failed" con un motivo), non nella risposta HTTP originale. Esegui sempre il polling del job.

# Verifica

Gli endpoint pubblici di verifica non generano mai errori su un numero seriale sconosciuto — restituiscono status: "unknown" (un codice falso/non emesso è una risposta significativa, non un 404).

# Avanti