API senzorů

Získat klíč

Klíč patří k vašemu účtu Atmy: jeden klíč na účet, zobrazí se jen jednou při vytvoření. Kdykoli ho můžete vydat znovu nebo zrušit, starý klíč okamžitě přestane fungovat.

Vytvořit klíč v účtu

Ověření

Posílejte klíč v hlavičce X-Atmy-Key nebo jako Authorization: Bearer. Uchovávejte ho na svém serveru, ne ve webové stránce či aplikaci.

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

Metody

• GET /v1/sensors — senzory s posledním údajem a kvalitou, 100 na stránku
• GET /v1/sensors/{id} — jeden senzor
• GET /v1/sensors/{id}/readings — surové údaje za posledních 31 dní, až 7 dní na požadavek, nebo hodinové průměry (interval=hour) za posledních 366 dní, až 92 dní na požadavek
• GET /v1/key — váš klíč, jeho limity a dnešní využití

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

Filtry /v1/sensors

• city — id nebo slug města, např. serbia/belgrade
• country — slug země, např. serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — senzory kolem bodu, do 50 km
• network — sensor_community, airgradient nebo atmy
• quality — all nebo passed
• mine — jen vaše senzory
• page, limit — stránky až po 500 senzorech

Kontrola kvality

Každou noc Atmy kontroluje ukončený den každého senzoru. Senzory, které neprojdou, zůstávají v API s quality.pm_eligible = false a důvody, rozhodnutí je na vás. Hodnoty měst a mapa používají jen senzory, které prošly. Údaje jsou takové, jak je zařízení poslalo, bez korekcí.

Jak se hodnoty počítají: metodika

Limity

60 požadavků za minutu a 10 000 za den UTC na klíč. Každá odpověď obsahuje X-RateLimit-Remaining a X-RateLimit-Daily-Remaining.

Licence

Každý senzor uvádí svou síť a její licenci: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Uveďte Atmy a síť. Senzory PurpleAir nejsou zahrnuty: jejich podmínky nedovolují další šíření. Vaše skryté senzory vidí jen váš klíč.