Sensör API’si

Anahtar alın

Anahtar Atmy hesabınıza aittir: hesap başına bir anahtar, oluşturulurken yalnızca bir kez gösterilir. İstediğiniz zaman yeniden oluşturabilir veya iptal edebilirsiniz, eski anahtar hemen çalışmayı bırakır.

Hesabınızda anahtar oluşturun

Kimlik doğrulama

Anahtarı X-Atmy-Key başlığında veya Authorization: Bearer olarak gönderin. Sunucunuzda saklayın, bir web sayfasına ya da uygulamaya koymayın.

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

Yöntemler

• GET /v1/sensors — son ölçüm ve kaliteyle sensörler, sayfa başına 100
• GET /v1/sensors/{id} — tek sensör
• GET /v1/sensors/{id}/readings — son 31 günün ham ölçümleri, istek başına 7 güne kadar, veya son 366 günün saatlik ortalamaları (interval=hour), istek başına 92 güne kadar
• GET /v1/key — anahtarınız, sınırları ve bugünkü kullanım

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 filtreleri

• city — şehir id veya slug, örneğin serbia/belgrade
• country — ülke slug, örneğin serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — bir nokta çevresindeki sensörler, 50 km’ye kadar
• network — sensor_community, airgradient veya atmy
• quality — all veya passed
• mine — yalnızca kendi sensörleriniz
• page, limit — en fazla 500 sensörlük sayfalar

Kalite denetimi

Atmy her gece her sensörün tamamlanan gününü denetler. Geçemeyen sensörler quality.pm_eligible = false ve gerekçelerle API’de kalır, karar sizindir. Şehir değerleri ve harita yalnızca geçen sensörleri kullanır. Ölçümler cihazın gönderdiği gibidir, düzeltme yapılmaz.

Değerler nasıl hesaplanır: metodoloji

Sınırlar

Anahtar başına dakikada 60 ve UTC gününde 10 000 istek. Her yanıtta X-RateLimit-Remaining ve X-RateLimit-Daily-Remaining bulunur.

Lisans

Her sensör ağını ve o ağın lisansını belirtir: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Atmy’yi ve ağı kaynak gösterin. PurpleAir sensörleri dahil değildir: koşulları yeniden dağıtıma izin vermez. Gizli sensörlerinizi yalnızca sizin anahtarınız görür.