API des capteurs

Chaque capteur de la carte Atmy avec sa position, son réseau, son contrôle qualité et ses mesures : PM1, PM2.5, PM10, température, humidité, pression et les autres canaux de l’appareil. Connectez-vous, créez une Developer Quick Key et envoyez-la avec chaque requête.

Obtenir une clé

La clé appartient à votre compte Atmy : une clé par compte, affichée une seule fois à la création. Vous pouvez la renouveler ou la révoquer à tout moment, l’ancienne cesse aussitôt de fonctionner.

Créer une clé dans votre compte

Authentification

Envoyez la clé dans l’en-tête X-Atmy-Key ou en Authorization: Bearer. Gardez-la sur votre serveur : ne la mettez pas dans une page web ni dans une application.

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

Méthodes

GET /v1/sensors — capteurs avec leur dernière mesure et leur qualité, 100 par page
GET /v1/sensors/{id} — un capteur
GET /v1/sensors/{id}/readings — mesures brutes 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
GET /v1/key — votre clé, ses limites et l’usage du jour

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

Filtres de /v1/sensors

city — id ou slug de la ville, par exemple serbia/belgrade
country — slug du pays, par exemple serbia
bbox — min_lon,min_lat,max_lon,max_lat
lat, lon, radius_km — capteurs autour d’un point, jusqu’à 50 km
network — sensor_community, airgradient ou atmy
quality — all ou passed
mine — seulement vos capteurs
page, limit — pages de 500 capteurs au plus

Contrôle qualité

Chaque nuit, Atmy contrôle la journée terminée de chaque capteur. Les capteurs refusés restent dans l’API avec quality.pm_eligible = false et les raisons : à vous de décider. Les valeurs des villes et la carte n’utilisent que les capteurs validés. Les mesures sont celles envoyées par l’appareil, sans correction.

Comment les valeurs sont calculées : méthodologie

Limites

60 requêtes par minute et 10 000 par jour UTC et par clé. Chaque réponse contient X-RateLimit-Remaining et X-RateLimit-Daily-Remaining.

Licence

Chaque capteur indique son réseau et la licence de celui-ci : Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Citez Atmy et le réseau. Les capteurs PurpleAir ne sont pas inclus : leurs conditions n’autorisent pas la redistribution. Vos capteurs masqués ne sont visibles que par votre clé.