API 参考

当前读数

一次请求获取每个传感器的最新读数，每分钟更新

所有传感器的当前读数

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

每个 IP 地址每分钟 60 次请求，无需密钥。每个响应都包含 X-RateLimit-Remaining。/v1/sensors/current 每分钟重建一次：更频繁地请求得到的是相同数据。

查询参数

network string 可选

sensor_community、airgradient 或 atmy

quality string 可选

All 或 passed

默认值: all

min_rating number 可选

仅评分不低于该值的传感器，0 到 10

bbox string 可选

min_lon,min_lat,max_lon,max_lat

GET/sensors/current?quality=passed&min_rating=8

curl "https://api.atmy.ai/v1/sensors/current?quality=passed&min_rating=8"

const response = await fetch("https://api.atmy.ai/v1/sensors/current?quality=passed&min_rating=8");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/sensors/current?quality=passed&min_rating=8").json()

200响应

{
  "api_version": "2.0",
  "generated_at": "2026-10-27T11:11:32+00:00",
  "count": 1644,
  "sensors": [
    {
      "id": 40656,
      "network_id": "airgradient",
      "lat": 19.094645,
      "lon": 101.529558,
      "city": null,
      "time": "2026-10-27T11:03:32+00:00",
      "pm1": 2.8,
      "pm25": 6.4,
      "pm10": 7.3,
      "temperature_c": 31,
      "humidity_percent": 48,
      "tvoc": 110.1,
      "quality": {
        "status": "good",
        "pm_eligible": true,
        "rating": 10
      }
    },
    {
      "id": 40657,
      "network_id": "airgradient",
      "lat": -34.0467846944686,
      "lon": 151.1229561199615,
      "city": "australia/sydney",
      "time": "2026-10-27T11:02:53+00:00",
      "pm25": 1,
      "temperature_c": 22.6,
      "humidity_percent": 63,
      "tvoc": 293.3,
      "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/networks/{network}/sensors/current

同一响应，仅限一个网络。

路径参数

network string 必填

sensor_community、airgradient 或 atmy。