Сенсорлор 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 сенсорлору кошулган эмес: алардын шарттары кайра таратууга уруксат бербейт. Жашыруун сенсорлоруңузду сиздин ачкычыңыз гана көрөт.