API de données — PolenMadrid

PolenMadrid propose une API REST pour consulter les niveaux de pollen, les données historiques, les stations et les types polliniques au format JSON.

Authentification

Toutes les requêtes nécessitent un token d'accès. Envoyez le token dans l'en-tête Authorization: Bearer <token> ou comme paramètre ?token=<token>.

Pour demander l'accès à l'API, contactez [email protected].

Endpoints disponibles

Endpoint	Paramètres	Description
`GET /api/niveles`	`fecha, estacion, tipo`	Niveaux actuels de pollen par station et type.
`GET /api/historico`	`estacion, tipo, desde, hasta, page, per_page`	Données historiques avec pagination.
`GET /api/estaciones`	—	Liste des stations avec niveau actuel.
`GET /api/estaciones/{code}`	—	Détail d'une station.
`GET /api/tipos`	—	Liste des types polliniques avec niveau actuel.
`GET /api/tipos/{code}`	—	Détail d'un type pollinique.
`GET /api/estadisticas`	`estacion, tipo, agrupacion, desde, hasta`	Statistiques agrégées (quotidien, hebdomadaire, mensuel, annuel).

Exemple d'utilisation

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

curl "https://polenmadrid.com/api/niveles?token=YOUR_TOKEN"

Limite de requêtes

Maximum 60 requêtes par minute par IP. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset indiquent l'état de la limite.

Format de réponse

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