传感器 API

获取密钥

密钥属于您的 Atmy 账户：每个账户一个密钥，仅在创建时显示一次。您可以随时重新签发或撤销，旧密钥会立即失效。

在账户中创建密钥

身份验证

在 X-Atmy-Key 请求头或 Authorization: Bearer 中发送密钥。请将其保存在您的服务器上，不要放入网页或应用。

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

方法

• GET /v1/sensors — 带最新读数和质量的传感器，每页 100 个
• GET /v1/sensors/{id} — 单个传感器
• GET /v1/sensors/{id}/readings — 最近 31 天的原始读数（每次最多 7 天），或最近 366 天的小时平均值（interval=hour，每次最多 92 天）
• GET /v1/key — 您的密钥、限额和今日用量

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

/v1/sensors 的筛选参数

• city — 城市 id 或 slug，例如 serbia/belgrade
• country — 国家 slug，例如 serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — 某点周围的传感器，最远 50 km
• network — sensor_community、airgradient 或 atmy
• quality — all 或 passed
• mine — 仅您自己的传感器
• page, limit — 每页最多 500 个传感器

质量检查

Atmy 每晚检查每个传感器已结束的一天。未通过的传感器仍保留在 API 中，标记为 quality.pm_eligible = false 并附原因，由您自行判断。城市数值和地图只使用通过检查的传感器。读数为设备发送的原始数据，未经校正。

数值的计算方式：方法说明

限额

每个密钥每分钟 60 次请求、每个 UTC 日 10 000 次。每个响应都包含 X-RateLimit-Remaining 和 X-RateLimit-Daily-Remaining。

许可

每个传感器都注明其网络及该网络的许可：Sensor.Community — ODbL 1.0 / DbCL 1.0，AirGradient — CC BY-SA 4.0。请注明 Atmy 和网络来源。不包含 PurpleAir 传感器：其条款不允许再分发。您隐藏的传感器只有您的密钥可见。