API датчиков

Каждый датчик карты Atmy с координатами, сетью, проверкой качества и показаниями: PM1, PM2.5, PM10, температура, влажность, давление и другие каналы, которые передаёт устройство. Войдите, создайте Developer Quick Key и передавайте его с каждым запросом.

Получить ключ

Ключ привязан к вашему аккаунту 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 км
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 нет: их условия не разрешают распространение. Ваши скрытые датчики видны только вашему ключу.