Sensor-API

Jeder Sensor der Atmy-Karte mit Standort, Netzwerk, Qualitätsprüfung und Messwerten: PM1, PM2.5, PM10, Temperatur, Luftfeuchte, Luftdruck und die weiteren Kanäle des Geräts. Melden Sie sich an, erstellen Sie einen Developer Quick Key und senden Sie ihn mit jeder Anfrage.

Schlüssel erhalten

Der Schlüssel gehört zu Ihrem Atmy-Konto: ein Schlüssel pro Konto, einmal beim Erstellen angezeigt. Sie können ihn jederzeit neu ausstellen oder widerrufen, der alte funktioniert dann sofort nicht mehr.

Schlüssel im Konto erstellen

Authentifizierung

Senden Sie den Schlüssel im Header X-Atmy-Key oder als Authorization: Bearer. Bewahren Sie ihn auf Ihrem Server auf, nicht in einer Webseite oder App.

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

Methoden

GET /v1/sensors — Sensoren mit letztem Messwert und Qualität, 100 pro Seite
GET /v1/sensors/{id} — ein Sensor
GET /v1/sensors/{id}/readings — Rohwerte der letzten 31 Tage, bis 7 Tage pro Anfrage, oder Stundenmittel (interval=hour) der letzten 366 Tage, bis 92 Tage pro Anfrage
GET /v1/key — Ihr Schlüssel, seine Limits und die heutige Nutzung

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

Filter von /v1/sensors

city — Stadt-ID oder Slug, etwa serbia/belgrade
country — Länder-Slug, etwa serbia
bbox — min_lon,min_lat,max_lon,max_lat
lat, lon, radius_km — Sensoren um einen Punkt, bis 50 km
network — sensor_community, airgradient oder atmy
quality — all oder passed
mine — nur Ihre eigenen Sensoren
page, limit — Seiten mit bis zu 500 Sensoren

Qualitätsprüfung

Jede Nacht prüft Atmy den abgeschlossenen Tag jedes Sensors. Sensoren, die durchfallen, bleiben mit quality.pm_eligible = false und den Gründen in der API, Sie entscheiden selbst. Stadtwerte und Karte nutzen nur bestandene Sensoren. Messwerte sind die Rohdaten des Geräts, ohne Korrekturen.

Wie die Werte berechnet werden: Methodik

Limits

60 Anfragen pro Minute und 10 000 pro UTC-Tag und Schlüssel. Jede Antwort enthält X-RateLimit-Remaining und X-RateLimit-Daily-Remaining.

Lizenz

Jeder Sensor nennt sein Netzwerk und dessen Lizenz: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Nennen Sie Atmy und das Netzwerk. PurpleAir-Sensoren fehlen: ihre Bedingungen erlauben keine Weitergabe. Ihre eigenen ausgeblendeten Sensoren sieht nur Ihr Schlüssel.