Érzékelő API

Kulcs igénylése

A kulcs az Atmy-fiókjához tartozik: fiókonként egy kulcs, létrehozáskor egyszer jelenik meg. Bármikor újra kiadhatja vagy visszavonhatja, a régi azonnal megszűnik működni.

Kulcs létrehozása a fiókban

Hitelesítés

Küldje a kulcsot az X-Atmy-Key fejlécben vagy Authorization: Bearer formában. Tartsa a saját szerverén, ne tegye weboldalba vagy alkalmazásba.

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

Metódusok

• GET /v1/sensors — érzékelők a legutóbbi méréssel és minőséggel, oldalanként 100
• GET /v1/sensors/{id} — egy érzékelő
• GET /v1/sensors/{id}/readings — nyers mérések az utolsó 31 napból, kérésenként legfeljebb 7 nap, vagy órás átlagok (interval=hour) az utolsó 366 napból, kérésenként legfeljebb 92 nap
• GET /v1/key — az Ön kulcsa, korlátai és mai használata

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

A /v1/sensors szűrői

• city — a város id-je vagy slugja, pl. serbia/belgrade
• country — az ország slugja, pl. serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — érzékelők egy pont körül, legfeljebb 50 km
• network — sensor_community, airgradient vagy atmy
• quality — all vagy passed
• mine — csak a saját érzékelői
• page, limit — legfeljebb 500 érzékelős oldalak

Minőségellenőrzés

Az Atmy minden éjjel ellenőrzi minden érzékelő lezárt napját. A kiszűrt érzékelők az API-ban maradnak quality.pm_eligible = false értékkel és az okokkal, Ön dönt. A városi értékek és a térkép csak az átment érzékelőket használják. A mérések az eszköz által küldött adatok, korrekció nélkül.

Hogyan számoljuk az értékeket: módszertan

Korlátok

Kulcsonként percenként 60 és UTC-naponként 10 000 kérés. Minden válasz tartalmazza az X-RateLimit-Remaining és X-RateLimit-Daily-Remaining fejlécet.

Licenc

Minden érzékelő megadja hálózatát és annak licencét: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Tüntesse fel az Atmyt és a hálózatot. PurpleAir-érzékelők nincsenek benne: feltételeik nem engedik a továbbadást. Rejtett érzékelőit csak az Ön kulcsa látja.