Sensorlar API

Kalit olish

Kalit Atmy hisobingizga bog‘langan: har bir hisobga bitta kalit, yaratilganda faqat bir marta ko‘rsatiladi. Uni istalgan vaqtda qayta chiqarish yoki bekor qilish mumkin, eski kalit darhol ishlamay qoladi.

Hisobingizda kalit yarating

Autentifikatsiya

Kalitni X-Atmy-Key sarlavhasida yoki Authorization: Bearer sifatida yuboring. Uni o‘z serveringizda saqlang, veb-sahifa yoki ilovaga qo‘ymang.

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

Metodlar

• GET /v1/sensors — so‘nggi ko‘rsatkich va sifat bilan sensorlar, sahifada 100 ta
• GET /v1/sensors/{id} — bitta sensor
• GET /v1/sensors/{id}/readings — so‘nggi 31 kunlik xom ko‘rsatkichlar, so‘rovga 7 kungacha, yoki so‘nggi 366 kunlik soatlik o‘rtachalar (interval=hour), so‘rovga 92 kungacha
• GET /v1/key — kalitingiz, uning cheklovlari va bugungi sarf

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 filtrlari

• city — shahar id yoki slug, masalan serbia/belgrade
• country — mamlakat slug, masalan serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — nuqta atrofidagi sensorlar, 50 km gacha
• network — sensor_community, airgradient yoki atmy
• quality — all yoki passed
• mine — faqat sizning sensorlaringiz
• page, limit — 500 tagacha sensorli sahifalar

Sifat tekshiruvi

Atmy har kecha har bir sensorning tugagan kunini tekshiradi. O‘tmagan sensorlar API’da quality.pm_eligible = false va sabablari bilan qoladi, qarorni o‘zingiz qilasiz. Shahar qiymatlari va xarita faqat o‘tgan sensorlardan foydalanadi. Ko‘rsatkichlar qurilma yuborganicha, tuzatishlarsiz.

Qiymatlar qanday hisoblanadi: metodika

Cheklovlar

Har bir kalit uchun daqiqasiga 60 va UTC kuniga 10 000 so‘rov. Har bir javobda X-RateLimit-Remaining va X-RateLimit-Daily-Remaining bor.

Litsenziya

Har bir sensor o‘z tarmog‘i va uning litsenziyasini ko‘rsatadi: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Atmy va tarmoqni manba sifatida ko‘rsating. PurpleAir sensorlari kiritilmagan: ularning shartlari qayta tarqatishga ruxsat bermaydi. Yashirin sensorlaringizni faqat sizning kalitingiz ko‘radi.