API pentru senzori

Fiecare senzor de pe harta Atmy cu locația, rețeaua, verificarea calității și citirile: PM1, PM2.5, PM10, temperatură, umiditate, presiune și celelalte canale ale dispozitivului. Autentificați-vă, creați o Developer Quick Key și trimiteți-o cu fiecare cerere.

Obțineți o cheie

Cheia aparține contului dumneavoastră Atmy: o cheie pe cont, afișată o singură dată la creare. O puteți reemite sau revoca oricând, iar cea veche nu mai funcționează imediat.

Creați o cheie în cont

Autentificare

Trimiteți cheia în antetul X-Atmy-Key sau ca Authorization: Bearer. Păstrați-o pe serverul dumneavoastră, nu într-o pagină web sau o aplicație.

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

Metode

GET /v1/sensors — senzori cu ultima citire și calitatea, câte 100 pe pagină
GET /v1/sensors/{id} — un senzor
GET /v1/sensors/{id}/readings — citiri brute din ultimele 31 de zile, până la 7 zile pe cerere, sau medii orare (interval=hour) din ultimele 366 de zile, până la 92 de zile pe cerere
GET /v1/key — cheia dumneavoastră, limitele și utilizarea de azi

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

Filtrele /v1/sensors

city — id sau slug al orașului, de exemplu serbia/belgrade
country — slug al țării, de exemplu serbia
bbox — min_lon,min_lat,max_lon,max_lat
lat, lon, radius_km — senzori în jurul unui punct, până la 50 km
network — sensor_community, airgradient sau atmy
quality — all sau passed
mine — doar senzorii dumneavoastră
page, limit — pagini de până la 500 de senzori

Verificarea calității

În fiecare noapte Atmy verifică ziua încheiată a fiecărui senzor. Senzorii respinși rămân în API cu quality.pm_eligible = false și motivele, iar decizia vă aparține. Valorile orașelor și harta folosesc doar senzorii admiși. Citirile sunt cele trimise de dispozitiv, fără corecții.

Cum se calculează valorile: metodologie

Limite

60 de cereri pe minut și 10 000 pe zi UTC pentru fiecare cheie. Fiecare răspuns conține X-RateLimit-Remaining și X-RateLimit-Daily-Remaining.

Licență

Fiecare senzor își indică rețeaua și licența acesteia: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Menționați Atmy și rețeaua. Senzorii PurpleAir nu sunt incluși: termenii lor nu permit redistribuirea. Senzorii dumneavoastră ascunși îi vede doar cheia dumneavoastră.