API de sensores

Obtener una clave

La clave pertenece a su cuenta de Atmy: una clave por cuenta, que se muestra una sola vez al crearla. Puede volver a emitirla o revocarla en cualquier momento, y la anterior deja de funcionar al instante.

Crear una clave en su cuenta

Autenticación

Envíe la clave en la cabecera X-Atmy-Key o como Authorization: Bearer. Guárdela en su servidor: no la ponga en una página web ni en una aplicación.

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

Métodos

• GET /v1/sensors — sensores con su última lectura y calidad, 100 por página
• GET /v1/sensors/{id} — un sensor
• GET /v1/sensors/{id}/readings — lecturas brutas de los últimos 31 días, hasta 7 días por solicitud, o medias horarias (interval=hour) de los últimos 366 días, hasta 92 días por solicitud
• GET /v1/key — su clave, sus límites y el uso de hoy

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

Filtros de /v1/sensors

• city — id o slug de la ciudad, por ejemplo serbia/belgrade
• country — slug del país, por ejemplo serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — sensores alrededor de un punto, hasta 50 km
• network — sensor_community, airgradient o atmy
• quality — all o passed
• mine — solo sus sensores
• page, limit — páginas de hasta 500 sensores

Control de calidad

Cada noche Atmy revisa el día completo de cada sensor. Los que no lo superan siguen en la API con quality.pm_eligible = false y los motivos, y usted decide. Los valores de las ciudades y el mapa usan solo los sensores aprobados. Las lecturas son las que envió el dispositivo, sin correcciones.

Cómo se calculan los valores: metodología

Límites

60 solicitudes por minuto y 10 000 por día UTC por clave. Cada respuesta incluye X-RateLimit-Remaining y X-RateLimit-Daily-Remaining.

Licencia

Cada sensor indica su red y la licencia de esa red: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Cite a Atmy y a la red. No se incluyen sensores de PurpleAir: sus condiciones no permiten redistribuir. Sus sensores ocultos solo los ve su clave.