Sistema y errores
Endpoints de sistema
Section titled “Endpoints de sistema”| Ruta | Uso |
|---|---|
GET /health |
Comprobación ligera de disponibilidad. |
GET /status |
Versión, tiempo activo, origen de datos y estadísticas de caché. |
GET /cache/clear |
Vacía la caché; no disponible en producción. |
{ "status": "ok", "version": "0.1.0" }Códigos de respuesta
Section titled “Códigos de respuesta”| Código | Significado |
|---|---|
200 |
La consulta se resolvió correctamente. |
400 |
Faltan filtros obligatorios o el DNI/NIE no es válido. |
403 |
Operación restringida, como vaciar caché en producción. |
404 |
El producto, cultivo o recurso solicitado no existe. |
422 |
Un parámetro no cumple el formato o rango esperado. |
429 |
Se superó el límite de solicitudes por IP. |
502 |
No se pudo consultar la fuente MAPA. Reintenta más tarde. |
Las respuestas de error incluyen un campo detail con la explicación concreta.
Límites y reintentos
Section titled “Límites y reintentos”La API limita las peticiones de cliente a 60 por minuto por IP de forma predeterminada. Las solicitudes al MAPA usan reintentos con espera progresiva y están limitadas a 2 por segundo. Para integraciones de volumen, pagina los resultados y aplica reintentos exponenciales ante 429 y 502.