API czujników

Uzyskaj klucz

Klucz należy do Twojego konta Atmy: jeden klucz na konto, pokazywany raz przy tworzeniu. Możesz go w każdej chwili wydać ponownie lub unieważnić, a stary od razu przestaje działać.

Utwórz klucz na koncie

Uwierzytelnianie

Wysyłaj klucz w nagłówku X-Atmy-Key lub jako Authorization: Bearer. Trzymaj go na swoim serwerze: nie umieszczaj go na stronie ani w aplikacji.

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

Metody

• GET /v1/sensors — czujniki z ostatnim odczytem i jakością, po 100 na stronę
• GET /v1/sensors/{id} — jeden czujnik
• GET /v1/sensors/{id}/readings — surowe odczyty z ostatnich 31 dni, do 7 dni na zapytanie, lub średnie godzinowe (interval=hour) z ostatnich 366 dni, do 92 dni na zapytanie
• GET /v1/key — Twój klucz, jego limity i dzisiejsze użycie

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 lub slug miasta, np. serbia/belgrade
• country — slug kraju, np. serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — czujniki wokół punktu, do 50 km
• network — sensor_community, airgradient lub atmy
• quality — all lub passed
• mine — tylko Twoje czujniki
• page, limit — strony do 500 czujników

Kontrola jakości

Co noc Atmy sprawdza zakończoną dobę każdego czujnika. Czujniki, które nie przejdą kontroli, zostają w API z quality.pm_eligible = false i powodami, a decyzja należy do Ciebie. Wartości miast i mapa używają tylko czujników, które przeszły. Odczyty to dane z urządzenia, bez korekt.

Jak liczone są wartości: metodyka

Limity

60 zapytań na minutę i 10 000 na dobę UTC na klucz. Każda odpowiedź zawiera X-RateLimit-Remaining i X-RateLimit-Daily-Remaining.

Licencja

Każdy czujnik podaje swoją sieć i jej licencję: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Podaj Atmy i sieć jako źródło. Czujników PurpleAir nie ma: ich warunki nie pozwalają na dalsze udostępnianie. Twoje ukryte czujniki widzi tylko Twój klucz.