Маълумотномаи API

Раддабандии шаҳрҳои кишвар

Шаҳрҳои кишвар аз рӯи миёнаи рӯзонаи PM2.5 барои рӯзи охирини анҷомёфта раддабандӣ мешаванд, аввал ифлостаринҳо ё тозатаринҳо; танҳо шаҳрҳои калон ё ҳамаи маҳалҳои аҳолинишин.

Раддабандии шаҳрҳои кишвар

GEThttps://api.atmy.ai/v1/ranking

Параметрҳои дархост

country string ҳатмӣ

Номи кишвар бо ҳар забони сомона ё рамзи ISO-и он.

order string ихтиёрӣ

Аввал most_polluted ё cleanest.

Пешфарз: most_polluted

settlements string ихтиёрӣ

cities — танҳо шаҳрҳои калон; all — ҳар маҳалли аҳолинишин бо сенсорҳои кофӣ.

Пешфарз: cities

limit integer ихтиёрӣ

Чанд шаҳр, то 50.

Пешфарз: 10

lang string ихтиёрӣ

Забони номҳои шаҳр ва кишвар ва пайванди саҳифа.

Пешфарз: en

GET/ranking?country=Germany&limit=10

curl "https://api.atmy.ai/v1/ranking?country=Germany&limit=10"

const response = await fetch("https://api.atmy.ai/v1/ranking?country=Germany&limit=10");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/ranking?country=Germany&limit=10").json()

200Ҷавоб

{
  "country": "Germany",
  "date": "2026-10-26",
  "period": "2026-10-26T00:00:00Z/2026-10-27T00:00:00Z",
  "order": "most_polluted",
  "settlements": "cities",
  "unit": "ug/m3",
  "method": "datahub_daily",
  "category_scale": "US_EPA_2024",
  "count": 76,
  "cities": [
    {
      "rank": 1,
      "id": 52005,
      "name": "Flensburg",
      "pm25": 39.2,
      "level": "unhealthy_for_sensitive_groups",
      "sensors": 10
    },
    {
      "rank": 2,
      "id": 52151,
      "name": "Würzburg",
      "pm25": 22.2,
      "level": "moderate",
      "sensors": 5
    }
  ]
}