सेंसर API

कुंजी पाएँ

कुंजी आपके Atmy खाते से जुड़ी है: हर खाते के लिए एक कुंजी, बनाते समय केवल एक बार दिखाई जाती है। आप इसे कभी भी दोबारा जारी या रद्द कर सकते हैं, और पुरानी कुंजी तुरंत काम करना बंद कर देती है।

अपने खाते में कुंजी बनाएँ

प्रमाणीकरण

कुंजी X-Atmy-Key हेडर में या Authorization: Bearer के रूप में भेजें। इसे अपने सर्वर पर रखें, किसी वेब पेज या ऐप में नहीं।

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

मेथड

• GET /v1/sensors — नवीनतम रीडिंग और गुणवत्ता के साथ सेंसर, प्रति पेज 100
• GET /v1/sensors/{id} — एक सेंसर
• GET /v1/sensors/{id}/readings — पिछले 31 दिनों की कच्ची रीडिंग, प्रति अनुरोध 7 दिन तक, या पिछले 366 दिनों के घंटेवार औसत (interval=hour), प्रति अनुरोध 92 दिन तक
• GET /v1/key — आपकी कुंजी, उसकी सीमाएँ और आज का उपयोग

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 के फ़िल्टर

• city — शहर का id या slug, जैसे serbia/belgrade
• country — देश का slug, जैसे serbia
• bbox — min_lon,min_lat,max_lon,max_lat
• lat, lon, radius_km — किसी बिंदु के आसपास के सेंसर, 50 km तक
• network — sensor_community, airgradient या atmy
• quality — all या passed
• mine — केवल आपके सेंसर
• page, limit — अधिकतम 500 सेंसर वाले पेज

गुणवत्ता जाँच

हर रात Atmy हर सेंसर के पूरे हुए दिन की जाँच करता है। जो सेंसर विफल होते हैं, वे quality.pm_eligible = false और कारणों के साथ API में बने रहते हैं, फ़ैसला आपका है। शहरों के मान और मानचित्र केवल पास हुए सेंसर का उपयोग करते हैं। रीडिंग वही है जो डिवाइस ने भेजी, बिना सुधार के।

मान कैसे गिने जाते हैं: कार्यप्रणाली

सीमाएँ

प्रति कुंजी प्रति मिनट 60 अनुरोध और प्रति UTC दिन 10 000। हर उत्तर में X-RateLimit-Remaining और X-RateLimit-Daily-Remaining होते हैं।

लाइसेंस

हर सेंसर अपना नेटवर्क और उसका लाइसेंस बताता है: Sensor.Community — ODbL 1.0 / DbCL 1.0, AirGradient — CC BY-SA 4.0। Atmy और नेटवर्क को श्रेय दें। PurpleAir सेंसर शामिल नहीं हैं: उनकी शर्तें पुनर्वितरण की अनुमति नहीं देतीं। आपके छिपे हुए सेंसर केवल आपकी कुंजी देख सकती है।