API senzora

Svaki senzor sa Atmy mape sa lokacijom, mrežom, proverom kvaliteta i očitavanjima: PM1, PM2.5, PM10, temperatura, vlažnost, pritisak i ostali kanali uređaja. Prijavite se, napravite Developer Quick Key i šaljite ga uz svaki zahtev.

Nabavite ključ

Ključ pripada vašem Atmy nalogu: jedan ključ po nalogu, prikazuje se jednom pri pravljenju. Možete ga ponovo izdati ili opozvati u bilo kom trenutku, a stari odmah prestaje da radi.

Napravite ključ na nalogu

Autentifikacija

Šaljite ključ u zaglavlju X-Atmy-Key ili kao Authorization: Bearer. Čuvajte ga na svom serveru, ne u veb-stranici ili aplikaciji.

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

Metode

GET /v1/sensors — senzori sa poslednjim očitavanjem i kvalitetom, po 100 na stranici
GET /v1/sensors/{id} — jedan senzor
GET /v1/sensors/{id}/readings — sirova očitavanja za poslednji 31 dan, do 7 dana po zahtevu, ili satni proseci (interval=hour) za poslednjih 366 dana, do 92 dana po zahtevu
GET /v1/key — vaš ključ, njegova ograničenja i današnja potrošnja

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

Filteri /v1/sensors

city — id ili slug grada, na primer serbia/belgrade
country — slug zemlje, na primer serbia
bbox — min_lon,min_lat,max_lon,max_lat
lat, lon, radius_km — senzori oko tačke, do 50 km
network — sensor_community, airgradient ili atmy
quality — all ili passed
mine — samo vaši senzori
page, limit — stranice do 500 senzora

Provera kvaliteta

Svake noći Atmy proverava završen dan svakog senzora. Senzori koji ne prođu ostaju u API-ju sa quality.pm_eligible = false i razlozima, a odluka je vaša. Vrednosti gradova i mapa koriste samo senzore koji su prošli. Očitavanja su onakva kakva je uređaj poslao, bez korekcija.

Како се рачунају вредности: методологија

Ograničenja

60 zahteva u minutu i 10 000 po UTC danu po ključu. Svaki odgovor sadrži X-RateLimit-Remaining i X-RateLimit-Daily-Remaining.

Лиценца

Svaki senzor navodi svoju mrežu i njenu licencu: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Navedite Atmy i mrežu. Senzori PurpleAir nisu uključeni: njihovi uslovi ne dozvoljavaju dalju distribuciju. Vaše skrivene senzore vidi samo vaš ključ.