Սենսորների 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-ի սենսորները ներառված չեն. նրանց պայմանները թույլ չեն տալիս վերատարածում։ Ձեր թաքցված սենսորները տեսնում է միայն ձեր բանալին։