Prisradar
Nozioni di base

Gli errori dell’API e cosa significano

Ogni errore ha un codice fisso per il Suo software e una frase in tedesco per il Suo log. Le richieste con errore non contano mai nel contingente.

Aggiornato il 21.10.2026Il team Prisradar

In questa pagina
Risposta 404
{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}
Risposta 429
{
  "error": {
    "code": "quota_exceeded",
    "message": "Das Kontingent von 2000 Bewertungen ist für diesen Monat aufgebraucht.",
    "resetsAt": "2026-10-31T23:00:00.000Z"
  }
}

Com’è fatto un errore?

Ogni errore arriva come JSON con l’oggetto error. error.code è un codice fisso in inglese a cui reagisce il Suo software. error.message è una frase in tedesco per il Suo log. Alcuni errori portano altri dati: error.field, error.suggestions o error.resetsAt. Un errore non conta mai nel contingente.

Quali errori ci sono?

400 significa che un campo manca o è sbagliato. 401 e 403 riguardano la chiave. 404 significa che marca o modello non sono nel catalogo. 422 significa che non c’è un valore affidabile. 429 significa troppo veloce o contingente esaurito. 503 significa che l’API è sospesa per poco tempo.

CampoTipoSignificato
400invalid_requestUn campo manca o è sbagliato; error.field lo indica.
401unauthorizedLa chiave manca, è sbagliata o revocata, oppure l’accesso è sospeso.
403forbiddenRichiesta da un indirizzo di server non autorizzato per la chiave.
404unknown_make · unknown_modelNon nel catalogo; error.suggestions indica nomi simili.
422too_few_comparables · too_oldNessun valore affidabile: troppo pochi confronti o più di 25 anni.
429rate_limited · quota_exceededTroppo veloce, oppure il contingente è esaurito; Retry-After o error.resetsAt dice quando si può riprendere.
503unavailableL’API è sospesa per poco tempo. Riprovare dopo qualche minuto.

Cosa fare con l’errore 429?

Controlli error.code. Con rate_limited ha inviato più di 60 richieste in un minuto; attenda i secondi indicati nell’header Retry-After. Con quota_exceeded il contingente del mese è esaurito; si riprende alla data in error.resetsAt, oppure subito con un pacchetto più grande. Se error.resetsAt manca, manca un pacchetto o il suo pagamento è in sospeso; error.message indica cosa fare.

Pacchetti e limiti: Limiti e pacchetti.

Quando deve riprovare il mio software?

Solo con 429 rate_limited e con 503, e solo dopo il tempo indicato nell’header Retry-After. Tutti gli altri errori si ripetono con la stessa richiesta: con 400 corregga il campo, con 404 il nome, e con 422 mostri un’avvertenza al posto di un valore.

Non ha trovato ciò che cerca?Scriva a info@prisradar.ch o tramite il modulo di contatto.

Digiti ciò che cerca: una funzione, una domanda o un codice d’errore.

↑ ↓ seleziona↵ apriEsc chiudi