Limiti ed errori
Ogni risposta porta X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset: vedete arrivare un limite invece di scoprirlo.
Le quote
Una chiave gratuita è 100 richieste al giorno e si azzera a mezzanotte UTC; il giorno dopo riprende invariata, senza nulla da rinnovare. Pro è 5.000 al giorno, Business 25.000 ed Enterprise è senza tetto con uso corretto.
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1761264000| status | meaning |
|---|---|
| 200 | A normal answer. Check X-RateLimit-Remaining while you are here. |
| 400 | A parameter could not be parsed — a non-numeric yearFrom, for instance. |
| 401 | Missing or unknown key. Send it as the x-api-key header. |
| 404 SOLD_OR_REMOVED | From /car: the vehicle is gone from Encar. Drop it on your side. |
| 429 | Daily allowance spent. X-RateLimit-Remaining tells you before it happens. |
| 503 | The Korean source did not answer in time. Retry once, then fall back. |
Gestire un'auto venduta
È l'errore per cui vale la pena scrivere codice. GET /car verifica la disponibilità dal vivo, quindi un veicolo uscito da Encar risponde 404 con il codice SOLD_OR_REMOVED. Trattatelo come segnale per rimuoverlo dal vostro sito, non come un guasto da riprovare: domani tornerà lo stesso 404.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }Ottieni la tua chiave API
Gratis · 100 richieste al giorno
Da leggere dopo
Combinateli liberamente in una sola chiamata. La risposta porta total, page, count e results[], quindi potete paginare su total senza una seconda richiesta.
I dati arrivano da una fonte coreana, quindi quattro di questi campi vengono letti male per impostazione predefinita. Ogni errore è silenzioso: la vostra pagina si disegna, è solo sbagliata.
Una cifra al mese, nessuna fatturazione a chiamata da prevedere e nessun costo di attivazione. Il piano gratuito è un piano vero, non una prova che scade.