API за сензори

Вземете ключ

Ключът е свързан с профила ви в Atmy: един ключ на профил, показва се веднъж при създаване. Можете да го издадете отново или да го отмените по всяко време, а старият веднага спира да работи.

Създайте ключ в профила

Удостоверяване

Изпращайте ключа в заглавката X-Atmy-Key или като Authorization: Bearer. Пазете го на сървъра си, не го слагайте в уеб страница или приложение.

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

Методи

• GET /v1/sensors — сензори с последното показание и качество, по 100 на страница
• GET /v1/sensors/{id} — един сензор
• GET /v1/sensors/{id}/readings — сурови показания за последните 31 дни, до 7 дни на заявка, или средночасови (interval=hour) за последните 366 дни, до 92 дни на заявка
• GET /v1/key — вашият ключ, лимитите и днешното ползване

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

Филтри на /v1/sensors

• city — id или slug на града, например serbia/belgrade
• country — slug на държавата, например serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — сензори около точка, до 50 km
• network — sensor_community, airgradient или atmy
• quality — all или passed
• mine — само вашите сензори
• page, limit — страници до 500 сензора

Проверка на качеството

Всяка нощ Atmy проверява завършения ден на всеки сензор. Неминалите остават в API с quality.pm_eligible = false и причините, а решението е ваше. Стойностите на градовете и картата използват само миналите проверката. Показанията са каквито ги е изпратило устройството, без корекции.

Как се изчисляват стойностите: методика

Лимити

60 заявки в минута и 10 000 на UTC денонощие за ключ. Всеки отговор съдържа X-RateLimit-Remaining и X-RateLimit-Daily-Remaining.

Лиценз

Всеки сензор посочва мрежата си и нейния лиценз: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Посочвайте Atmy и мрежата. Сензори на PurpleAir няма: условията им не позволяват разпространение. Скритите ви сензори вижда само вашият ключ.