Límites y errores
Cada respuesta lleva X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, así que ves venir un límite en vez de descubrirlo.
Las cuotas
Una clave gratuita son 100 peticiones al día y se reinicia a medianoche UTC; al día siguiente continúa igual, sin nada que renovar. Pro son 5.000 al día, Business 25.000 y Enterprise no tiene tope bajo uso razonable.
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. |
Gestionar un coche vendido
Este es el error que merece código propio. GET /car comprueba la disponibilidad en vivo, así que un vehículo que ha salido de Encar responde 404 con el código SOLD_OR_REMOVED. Trátalo como señal para despublicarlo en tu lado, no como un fallo que reintentar: mañana devolverá el mismo 404.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }Consigue tu clave API
Gratis · 100 peticiones al día
Sigue leyendo
Combínalos como quieras en una sola llamada. La respuesta lleva total, page, count y results[], así que puedes paginar sobre total sin una segunda petición.
Los datos vienen de una fuente coreana, así que cuatro de estos campos se leen mal por defecto. Cada fallo es silencioso: tu página se renderiza, simplemente es incorrecta.
Una cifra al mes, sin facturación por llamada que haya que prever y sin cuota de alta. El plan gratuito es un plan de verdad, no una prueba que caduca.