Сенсорлар 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 күнге дейін, не соңғы 366 күннің сағаттық орташалары (interval=hour), сұрауға 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 және UTC тәулігіне 10 000 сұрау. Әр жауапта X-RateLimit-Remaining және X-RateLimit-Daily-Remaining бар.

Лицензия

Әр сенсор өз желісін және оның лицензиясын көрсетеді: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Atmy мен желіні дереккөз ретінде көрсетіңіз. PurpleAir сенсорлары қосылмаған: олардың шарттары қайта таратуға рұқсат бермейді. Жасырын сенсорларыңызды тек сіздің кілтіңіз көреді.