სენსორების 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 ყოველ ღამე ამოწმებს თითოეული სენსორის დასრულებულ დღეს. ვერგასული სენსორები API-ში რჩება quality.pm_eligible = false-ით და მიზეზებით, გადაწყვეტილება თქვენზეა. ქალაქების მნიშვნელობები და რუკა მხოლოდ გასულ სენსორებს იყენებს. ჩვენებები ისეთივეა, როგორც მოწყობილობამ გამოაგზავნა, შესწორების გარეშე.

როგორ ითვლება მნიშვნელობები: მეთოდიკა

ლიმიტები

თითო გასაღებზე წუთში 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-ის სენსორები არ შედის: მათი პირობები ხელახლა გავრცელებას არ უშვებს. თქვენს დამალულ სენსორებს მხოლოდ თქვენი გასაღები ხედავს.