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.
{
"error": {
"code": "unknown_make",
"message": "Die Marke «Ferari» kennen wir nicht.",
"suggestions": [
"Ferrari"
]
}
}{
"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.
| Campo | Tipo | Significato |
|---|---|---|
400 | invalid_request | Un campo manca o è sbagliato; error.field lo indica. |
401 | unauthorized | La chiave manca, è sbagliata o revocata, oppure l’accesso è sospeso. |
403 | forbidden | Richiesta da un indirizzo di server non autorizzato per la chiave. |
404 | unknown_make · unknown_model | Non nel catalogo; error.suggestions indica nomi simili. |
422 | too_few_comparables · too_old | Nessun valore affidabile: troppo pochi confronti o più di 25 anni. |
429 | rate_limited · quota_exceeded | Troppo veloce, oppure il contingente è esaurito; Retry-After o error.resetsAt dice quando si può riprendere. |
503 | unavailable | L’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.