Referência da API

Leituras

O histórico de um sensor — bruto, de 5 minutos, horário ou diário — e a média de um grupo de sensores.

Leituras de um sensor

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

Leituras brutas ou médias de 5 minutos (interval=5min) dos últimos 31 dias, até 7 dias por solicitação, ou médias horárias (interval=hour) dos últimos 366 dias, até 92 dias por solicitação, ou médias diárias (interval=day) com a verificação de cada dia, até um ano por solicitação

Parâmetros de caminho

id string obrigatório

Id do sensor, como na lista de sensores.

Parâmetros de consulta

interval string opcional

raw, 5min, hour ou day.

Padrão: raw

from string opcional

Início, ISO 8601 ou segundos Unix, UTC.

to string opcional

Fim, ISO 8601 ou segundos Unix, UTC; por padrão agora.

GET/sensors/41504/readings?interval=day

curl "https://api.atmy.ai/v1/sensors/41504/readings?interval=day"

const response = await fetch("https://api.atmy.ai/v1/sensors/41504/readings?interval=day");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/sensors/41504/readings?interval=day").json()

200Resposta

{
  "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/"
}

Média de um grupo de sensores

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

A média de até 100 sensores (ids=1,2,3) a cada 5 minutos ou a cada hora, cada sensor contado uma vez, por dia (interval=day) até 92 dias por solicitação

Parâmetros de consulta

ids string obrigatório

Ids de sensores separados por vírgulas, de 1 a 100.

interval string opcional

5min, hour ou day.

Padrão: hour

from string opcional

Início, ISO 8601 ou segundos Unix, UTC.

to string opcional

Fim, ISO 8601 ou segundos Unix, UTC; por padrão agora.

GET/sensors/readings?ids=41504,41752,43057&interval=hour

curl "https://api.atmy.ai/v1/sensors/readings?ids=41504,41752,43057&interval=hour"

const response = await fetch("https://api.atmy.ai/v1/sensors/readings?ids=41504,41752,43057&interval=hour");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/sensors/readings?ids=41504,41752,43057&interval=hour").json()

200Resposta

{
  "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/"
}