Sensor API-si

Açar əldə edin

Açar Atmy hesabınıza aiddir: hər hesaba bir açar, yaradılanda yalnız bir dəfə göstərilir. Onu istənilən vaxt yenidən buraxa və ya ləğv edə bilərsiniz, köhnə açar dərhal işləməyi dayandırır.

Hesabınızda açar yaradın

Autentifikasiya

Açarı X-Atmy-Key başlığında və ya Authorization: Bearer kimi göndərin. Onu öz serverinizdə saxlayın, veb səhifəyə və ya tətbiqə qoymayın.

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

Metodlar

• GET /v1/sensors — son göstərici və keyfiyyətlə sensorlar, səhifədə 100
• GET /v1/sensors/{id} — bir sensor
• GET /v1/sensors/{id}/readings — son 31 günün xam göstəriciləri, sorğuda 7 günə qədər, və ya son 366 günün saatlıq ortalamaları (interval=hour), sorğuda 92 günə qədər
• GET /v1/key — açarınız, limitləri və bugünkü istifadə

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 filtrləri

• city — şəhərin id və ya slug-ı, məsələn serbia/belgrade
• country — ölkənin slug-ı, məsələn serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — nöqtə ətrafındakı sensorlar, 50 km-ə qədər
• network — sensor_community, airgradient və ya atmy
• quality — all və ya passed
• mine — yalnız öz sensorlarınız
• page, limit — 500 sensora qədər səhifələr

Keyfiyyət yoxlaması

Atmy hər gecə hər sensorun başa çatmış gününü yoxlayır. Keçməyən sensorlar API-də quality.pm_eligible = false və səbəblərlə qalır, qərarı özünüz verirsiniz. Şəhər dəyərləri və xəritə yalnız keçən sensorlardan istifadə edir. Göstəricilər cihazın göndərdiyi kimidir, düzəlişsiz.

Dəyərlər necə hesablanır: metodika

Limitlər

Hər açar üçün dəqiqədə 60 və UTC günündə 10 000 sorğu. Hər cavabda X-RateLimit-Remaining və X-RateLimit-Daily-Remaining var.

Lisenziya

Hər sensor öz şəbəkəsini və onun lisenziyasını göstərir: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Atmy və şəbəkəni mənbə kimi göstərin. PurpleAir sensorları daxil deyil: onların şərtləri yenidən yaymağa icazə vermir. Gizli sensorlarınızı yalnız sizin açarınız görür.