センサー API

キーを取得

キーは Atmy アカウントに紐づきます：1 アカウントにつき 1 つ、作成時に一度だけ表示されます。いつでも再発行や無効化ができ、古いキーはすぐに使えなくなります。

アカウントでキーを作成

認証

キーは 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 — 最新値と品質付きのセンサー、1 ページ 100 件
• GET /v1/sensors/{id} — 1 つのセンサー
• GET /v1/sensors/{id}/readings — 直近 31 日の生データ（1 回 7 日まで）、または直近 366 日の時間平均（interval=hour、1 回 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 — 1 ページ最大 500 件

品質チェック

Atmy は毎晩、各センサーの完了した 1 日を確認します。不合格のセンサーも quality.pm_eligible = false と理由付きで API に残るので、判断はあなた次第です。都市の値とマップは合格したセンサーのみを使います。測定値はデバイスが送ったままで、補正はしていません。

値の計算方法：方法論

上限

キーごとに 1 分あたり 60 リクエスト、UTC 1 日あたり 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 のセンサーは含まれません：再配布が規約で認められていないためです。非表示にした自分のセンサーは自分のキーでのみ見えます。