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 рӯз дар як дархост, ё миёнаҳои соатбайъи (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 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 дохил нестанд: шартҳои онҳо паҳнкунии дубораро иҷозат намедиҳанд. Сенсорҳои пинҳонии шуморо танҳо калиди шумо мебинад.