API dati

PolenMadrid offre un'API REST per consultare i livelli di polline, i dati storici, le stazioni e i tipi pollinici in formato JSON.

Autenticazione

Tutte le richieste richiedono un token di accesso. Invia il token nell'header Authorization: Bearer <token> o come parametro ?token=<token>.

Per richiedere l'accesso all'API, contatta [email protected].

Endpoint disponibili

Endpoint Parametri Descrizione
GET /api/niveles fecha, estacion, tipo Livelli attuali di polline per stazione e tipo.
GET /api/historico estacion, tipo, desde, hasta, page, per_page Dati storici con paginazione.
GET /api/estaciones — Elenco delle stazioni con livello attuale.
GET /api/estaciones/{code} — Dettaglio di una stazione.
GET /api/tipos — Elenco dei tipi pollinici con livello attuale.
GET /api/tipos/{code} — Dettaglio di un tipo pollinico.
GET /api/estadisticas estacion, tipo, agrupacion, desde, hasta Statistiche aggregate (giornaliero, settimanale, mensile, annuale).

Esempio di utilizzo

curl -H "Authorization: Bearer YOUR_TOKEN" https://polenmadrid.com/api/niveles
curl "https://polenmadrid.com/api/niveles?token=YOUR_TOKEN"

Limite di richieste

Massimo 60 richieste al minuto per IP. Gli header X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset indicano lo stato del limite.

Formato di risposta

{
  "ok": true,
  "data": [...],
  "meta": {
    "total": 150,
    "last_updated": "2026-02-18"
  }
}