Hujjat

API hujjati

Barcha endpointlar faqat GETso'rovini qabul qiladi va application/json qaytaradi.

Baza manzil

https://meteo.gisdev.uz/api

Eng oddiy so'rov

curl -H "Authorization: Bearer agw_live_..." \
  "https://meteo.gisdev.uz/api/v1/weather/daily?latitude=41.31&longitude=69.28&date=2026-07-24"

Qaysi sanalar mavjud

Ma'lumot 2026-yil fevralidan boshlab yig'iladi. Eng yangi kunlar uchun ma'lumot bo'lmaydi— manbalar kechikish bilan chiqadi. Mavjud bo'lmagan sana 404 qaytaradi.

Harorat va namlik

ERA5-Land

Bugungi kundan ~6 kun oldingacha. Manba reanaliz — u shu kechikish bilan chiqadi.

Yog'ingarchilik

CHIRPS

Bugungi kundan ~5 kun oldingacha. Oxirgi ~3 hafta dastlabki qiymat, keyin aniqlashtiriladi.

Autentifikatsiya

Kalitni kabinetdan oling va har so'rovda Authorization sarlavhasida yuboring.

Kalit bilan so'rov

curl -H "Authorization: Bearer agw_live_..." \
  "https://meteo.gisdev.uz/api/v1/weather/history?latitude=41.31&longitude=69.28&start_date=2026-07-20&end_date=2026-07-24"

Sinab ko'rish uchun ?api_key= parametri ham ishlaydi, lekin u server jurnallariga tushadi — ishchi kodda sarlavhadan foydalaning.

Limitlar

Har tarifda kunlik so'rovlar soni cheklangan. Hisob barcha kalitlar bo'yicha umumiy va har kuni yarim tunda noldan boshlanadi. Joriy holat kabinetda ko'rinadi, tariflar — narxlar sahifasida.

Xato javoblari

Kod	Nomi	Qachon
400	Bad Request	Parametr noto'g'ri yoki koordinata O'zbekiston hududidan tashqarida
401	Unauthorized	Kalit yo'q yoki noto'g'ri
404	Not Found	So'ralgan sana va nuqta uchun ma'lumot topilmadi. Faqat /daily — /history bo'sh ro'yxat bilan 200 qaytaradi
429	Too Many Requests	Kunlik limit tugadi

401 — kalit yo'q

{
  "detail": "Bu endpoint uchun API kalit kerak. Kabinetdan kalit oling va 'Authorization: Bearer <kalit>' sarlavhasida yuboring."
}

429 — kunlik limit tugadi

{
  "detail": "Request was throttled. Expected available in 58967 seconds."
}

Javobda Retry-Aftersarlavhasi bo'ladi — qayta urinishgacha necha soniya qolgani.

Endpointlar

GET/v1/weather/dailyKalit majburiy

Kunlik ma'lumot

Bitta koordinata va sana uchun kunlik yozuv. Koordinata eng yaqin 0.1° (~10 km) katak markaziga bog'lanadi.

Parametr	Turi	Majburiy	Izoh
latitude	float	Ha	O'zbekiston chegarasida
longitude	float	Ha	O'zbekiston chegarasida
date	YYYY-MM-DD	Ha	Bazada mavjud sana

So'rov

curl -H "Authorization: Bearer agw_live_..." \
  "https://meteo.gisdev.uz/api/v1/weather/daily?latitude=41.31&longitude=69.28&date=2026-07-24"

Javob

{
  "date": "2026-07-24",
  "requested_point": { "latitude": 41.31, "longitude": 69.28 },
  "temperature":   { "min": 19.08, "max": 32.56, "mean": 26.55, "unit": "C" },
  "humidity":      { "mean": 41.63, "unit": "percent" },
  "precipitation": { "sum": 0.0, "unit": "mm" }
}

Diqqat: requested_point — siz yuborgan koordinata, qiymat olingan katak markazi emas. Bir katak ichidagi barcha koordinatalar (masalan 41.28 va 41.34) bir xil natija qaytaradi.

Sana uchun ma'lumot bo'lmasa 404 qaytadi.

GET/v1/weather/historyKalit majburiy

Sana oralig'i

Bir nuqta uchun bir necha kunlik ma'lumot. Oraliq ko'pi bilan 366 kun.

Parametr	Turi	Majburiy	Izoh
latitude	float	Ha	O'zbekiston chegarasida
longitude	float	Ha	O'zbekiston chegarasida
start_date	YYYY-MM-DD	Ha	Oraliq boshi (kiritiladi)
end_date	YYYY-MM-DD	Ha	Oraliq oxiri (kiritiladi)

So'rov

curl -H "Authorization: Bearer agw_live_..." \
  "https://meteo.gisdev.uz/api/v1/weather/history?latitude=41.31&longitude=69.28&start_date=2026-07-20&end_date=2026-07-24"

Javob

{
  "requested_point": { "latitude": 41.31, "longitude": 69.28 },
  "count": 3,
  "days": [
    {
      "date": "2026-07-22",
      "temperature":   { "min": 21.89, "max": 31.32, "mean": 26.73, "unit": "C" },
      "humidity":      { "mean": 37.3, "unit": "percent" },
      "precipitation": { "sum": 0.0, "unit": "mm" }
    },
    {
      "date": "2026-07-23",
      "...": "har kun uchun yuqoridagi shakldagi obyekt"
    }
  ],
  "start_date": "2026-07-22",
  "end_date": "2026-07-24"
}

daily dan farqli: ma'lumot topilmasa 404 emas, 200 va bo'sh daysro'yxati qaytadi. Oraliqning bir qismida ma'lumot bo'lmasa, o'sha kunlar ro'yxatga umuman kirmaydi — count ni tekshiring.

Javob maydonlari

temperature: min, max, mean — °C, yer sathidan 2 m balandlikda.
humidity: Faqat mean— foizda. Eng past va eng yuqori namlik berilmaydi: ular kun davomida turli soatlarda kuzatiladi va kunlik qiymat sifatida chalg'itardi.
precipitation: sum— bir kunda tushgan yog'in, mm.
null qiymatlar: Maydon nullbo'lishi mumkin — o'sha ko'rsatkich shu kun uchun mavjud emas degani.