API dei sensori

Ottenere una chiave

La chiave appartiene al suo account Atmy: una chiave per account, mostrata una sola volta alla creazione. Può rinnovarla o revocarla in qualsiasi momento, e la vecchia smette subito di funzionare.

Crea una chiave nel suo account

Autenticazione

Invii la chiave nell’intestazione X-Atmy-Key o come Authorization: Bearer. La tenga sul suo server: non la inserisca in una pagina web o in un’app.

curl -H "X-Atmy-Key: atmy_dk_…" "https://api.atmy.ai/v1/sensors?city=serbia/belgrade&quality=passed"

Metodi

• GET /v1/sensors — sensori con l’ultima misura e la qualità, 100 per pagina
• GET /v1/sensors/{id} — un sensore
• GET /v1/sensors/{id}/readings — misure grezze degli ultimi 31 giorni, fino a 7 giorni per richiesta, o medie orarie (interval=hour) degli ultimi 366 giorni, fino a 92 giorni per richiesta
• GET /v1/key — la sua chiave, i limiti e l’uso di oggi

curl -H "X-Atmy-Key: atmy_dk_…" "https://api.atmy.ai/v1/sensors/{id}/readings?interval=hour&from=2026-10-01&to=2026-10-08"

OpenAPI

Filtri di /v1/sensors

• city — id o slug della città, ad esempio serbia/belgrade
• country — slug del paese, ad esempio serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — sensori intorno a un punto, fino a 50 km
• network — sensor_community, airgradient o atmy
• quality — all o passed
• mine — solo i suoi sensori
• page, limit — pagine fino a 500 sensori

Controllo di qualità

Ogni notte Atmy controlla il giorno concluso di ogni sensore. I sensori scartati restano nell’API con quality.pm_eligible = false e i motivi: decide lei. I valori delle città e la mappa usano solo i sensori promossi. Le misure sono quelle inviate dal dispositivo, senza correzioni.

Come si calcolano i valori: metodologia

Limiti

60 richieste al minuto e 10 000 per giorno UTC per chiave. Ogni risposta riporta X-RateLimit-Remaining e X-RateLimit-Daily-Remaining.

Licenza

Ogni sensore indica la sua rete e la licenza di quella rete: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Citi Atmy e la rete. I sensori PurpleAir non sono inclusi: le loro condizioni non consentono la ridistribuzione. I suoi sensori nascosti li vede solo la sua chiave.