Ծրագրավորողներին

API տեղեկատու

Ցուցմունքներ

Մեկ սենսորի պատմությունը՝ հում, 5-րոպեանոց, ժամային կամ օրական, և սենսորների խմբի միջինը։

Սենսորի ցուցմունքները

GEThttps://api.atmy.ai/v1/sensors/{id}/readings

Վերջին 31 օրվա հում ցուցմունքներ կամ 5-րոպեանոց միջիններ (interval=5min), հարցման մեջ մինչև 7 օր, կամ վերջին 366 օրվա ժամային միջիններ (interval=hour), հարցման մեջ մինչև 92 օր, կամ օրական միջիններ (interval=day)՝ յուրաքանչյուր օրվա ստուգմամբ, հարցման մեջ մինչև մեկ տարի

Ուղու պարամետրեր

id string պարտադիր

Սենսորի id-ն, ինչպես սենսորների ցանկում։

Հարցման պարամետրեր

interval string ոչ պարտադիր

raw, 5min, hour կամ day։

Լռելյայն: raw

from string ոչ պարտադիր

Սկիզբ, ISO 8601 կամ Unix վայրկյաններ, UTC։

to string ոչ պարտադիր

Ավարտ, ISO 8601 կամ Unix վայրկյաններ, UTC․ լռելյայն՝ հիմա։

GET/sensors/41504/readings?interval=day
curl "https://api.atmy.ai/v1/sensors/41504/readings?interval=day"
200Պատասխան
{
  "api_version": "2.0",
  "sensor_id": 41504,
  "interval": "day",
  "from": "2026-10-24T00:00:00+00:00",
  "to": "2026-10-26T00:00:00+00:00",
  "readings": [
    {
      "time": "2026-10-24T00:00:00+00:00",
      "readings": 96,
      "pm1": 21.26,
      "pm25": 32.51,
      "pm10": 36.47,
      "temperature_c": 17.01,
      "humidity_percent": 44.66,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    },
    {
      "time": "2026-10-25T00:00:00+00:00",
      "readings": 96,
      "pm1": 35.5,
      "pm25": 59.98,
      "pm10": 71.05,
      "temperature_c": 14.87,
      "humidity_percent": 55.7,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    }
  ],
  "attribution": "Sensor data: Atmy (atmy.ai), from the networks named in each sensor's \"network\", under that network's license.",
  "terms": "https://atmy.ai/legal/data/"
}

Սենսորների խմբի միջինը

GEThttps://api.atmy.ai/v1/sensors/readings

Մինչև 100 սենսորի (ids=1,2,3) միջինը յուրաքանչյուր 5 րոպեի կամ ժամի համար, յուրաքանչյուր սենսոր հաշվվում է մեկ անգամ, ըստ օրերի (interval=day)՝ հարցման մեջ մինչև 92 օր

Հարցման պարամետրեր

ids string պարտադիր

Ստորակետով բաժանված սենսորների id-ներ, 1-ից 100։

interval string ոչ պարտադիր

5min, hour կամ day։

Լռելյայն: hour

from string ոչ պարտադիր

Սկիզբ, ISO 8601 կամ Unix վայրկյաններ, UTC։

to string ոչ պարտադիր

Ավարտ, ISO 8601 կամ Unix վայրկյաններ, UTC․ լռելյայն՝ հիմա։

GET/sensors/readings?ids=41504,41752,43057&interval=hour
curl "https://api.atmy.ai/v1/sensors/readings?ids=41504,41752,43057&interval=hour"
200Պատասխան
{
  "api_version": "2.0",
  "sensor_ids": [
    41504,
    41752,
    43057
  ],
  "interval": "hour",
  "from": "2026-10-26T00:00:00+00:00",
  "to": "2026-10-26T02:00:00+00:00",
  "readings": [
    {
      "time": "2026-10-26T00:00:00+00:00",
      "sensors": 3,
      "readings": 12,
      "pm1": 41.04,
      "pm25": 68.88,
      "pm10": 81.14,
      "temperature_c": 15.53,
      "humidity_percent": 54.33,
      "tvoc": 279.55
    },
    {
      "time": "2026-10-26T01:00:00+00:00",
      "sensors": 3,
      "readings": 12,
      "pm1": 37.93,
      "pm25": 62.65,
      "pm10": 76.3,
      "temperature_c": 15.55,
      "humidity_percent": 55.33,
      "tvoc": 178.2
    }
  ],
  "attribution": "Sensor data: Atmy (atmy.ai), from the networks named in each sensor's \"network\", under that network's license.",
  "terms": "https://atmy.ai/legal/data/"
}