Référence de l’API

Mesures

L’historique d’un capteur — brut, sur 5 minutes, horaire ou journalier — et la moyenne d’un groupe de capteurs.

Mesures d’un capteur

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

Mesures brutes ou moyennes sur 5 minutes (interval=5min) des 31 derniers jours, jusqu’à 7 jours par requête, ou moyennes horaires (interval=hour) des 366 derniers jours, jusqu’à 92 jours par requête, ou moyennes journalières (interval=day) avec le contrôle de chaque jour, jusqu’à un an par requête

Paramètres de chemin

id string obligatoire

Id du capteur, comme dans la liste des capteurs.

Paramètres de requête

interval string facultatif

raw, 5min, hour ou day.

Par défaut: raw

from string facultatif

Début, ISO 8601 ou secondes Unix, UTC.

to string facultatif

Fin, ISO 8601 ou secondes Unix, UTC ; par défaut maintenant.

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()

200Réponse

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

Moyenne d’un groupe de capteurs

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

La moyenne de 100 capteurs au plus (ids=1,2,3) par 5 minutes ou par heure, chaque capteur compté une fois, par jour (interval=day) jusqu’à 92 jours par requête

Paramètres de requête

ids string obligatoire

Id des capteurs séparés par des virgules, de 1 à 100.

interval string facultatif

5min, hour ou day.

Par défaut: hour

from string facultatif

Début, ISO 8601 ou secondes Unix, UTC.

to string facultatif

Fin, ISO 8601 ou secondes Unix, UTC ; par défaut maintenant.

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()

200Réponse

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