API de sensores

Obter uma chave

A chave pertence à sua conta Atmy: uma chave por conta, exibida uma só vez na criação. Você pode reemiti-la ou revogá-la a qualquer momento, e a antiga deixa de funcionar na hora.

Criar uma chave na sua conta

Autenticação

Envie a chave no cabeçalho X-Atmy-Key ou como Authorization: Bearer. Guarde-a no seu servidor: não a coloque numa página web nem num app.

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

Métodos

• GET /v1/sensors — sensores com a última leitura e a qualidade, 100 por página
• GET /v1/sensors/{id} — um sensor
• GET /v1/sensors/{id}/readings — leituras brutas dos últimos 31 dias, até 7 dias por solicitação, ou médias horárias (interval=hour) dos últimos 366 dias, até 92 dias por solicitação
• GET /v1/key — sua chave, seus limites e o uso de hoje

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 ou slug da cidade, por exemplo serbia/belgrade
• country — slug do país, por exemplo serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — sensores ao redor de um ponto, até 50 km
• network — sensor_community, airgradient ou atmy
• quality — all ou passed
• mine — só os seus sensores
• page, limit — páginas de até 500 sensores

Verificação de qualidade

Toda noite a Atmy verifica o dia completo de cada sensor. Os reprovados continuam na API com quality.pm_eligible = false e os motivos, e você decide. Os valores das cidades e o mapa usam só os aprovados. As leituras são as que o dispositivo enviou, sem correções.

Como os valores são calculados: metodologia

Limites

60 solicitações por minuto e 10 000 por dia UTC por chave. Cada resposta traz X-RateLimit-Remaining e X-RateLimit-Daily-Remaining.

Licença

Cada sensor informa sua rede e a licença dela: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Dê crédito à Atmy e à rede. Sensores PurpleAir não estão incluídos: seus termos não permitem redistribuição. Seus sensores ocultos só a sua chave vê.