API sensor

Dapatkan kunci

Kunci terikat pada akun Atmy Anda: satu kunci per akun, ditampilkan sekali saat dibuat. Anda bisa menerbitkan ulang atau mencabutnya kapan saja, dan kunci lama langsung berhenti berfungsi.

Buat kunci di akun Anda

Autentikasi

Kirim kunci di header X-Atmy-Key atau sebagai Authorization: Bearer. Simpan di server Anda, jangan di halaman web atau aplikasi.

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

Metode

• GET /v1/sensors — sensor dengan bacaan terakhir dan kualitasnya, 100 per halaman
• GET /v1/sensors/{id} — satu sensor
• GET /v1/sensors/{id}/readings — bacaan mentah 31 hari terakhir, hingga 7 hari per permintaan, atau rata-rata per jam (interval=hour) 366 hari terakhir, hingga 92 hari per permintaan
• GET /v1/key — kunci Anda, batasnya, dan pemakaian hari ini

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

Filter /v1/sensors

• city — id atau slug kota, misalnya serbia/belgrade
• country — slug negara, misalnya serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — sensor di sekitar titik, hingga 50 km
• network — sensor_community, airgradient, atau atmy
• quality — all atau passed
• mine — hanya sensor Anda
• page, limit — halaman hingga 500 sensor

Pemeriksaan kualitas

Setiap malam Atmy memeriksa hari yang sudah selesai dari setiap sensor. Sensor yang gagal tetap ada di API dengan quality.pm_eligible = false beserta alasannya, dan Anda yang memutuskan. Nilai kota dan peta hanya memakai sensor yang lolos. Bacaan adalah data kiriman perangkat, tanpa koreksi.

Cara nilai dihitung: metodologi

Batas

60 permintaan per menit dan 10 000 per hari UTC untuk tiap kunci. Setiap jawaban memuat X-RateLimit-Remaining dan X-RateLimit-Daily-Remaining.

Lisensi

Setiap sensor menyebut jaringannya dan lisensi jaringan itu: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0. Cantumkan Atmy dan jaringannya. Sensor PurpleAir tidak termasuk: ketentuannya tidak mengizinkan distribusi ulang. Sensor tersembunyi milik Anda hanya terlihat oleh kunci Anda.