Namoz vaqti API — Hujjat

Ushbu sahifa JSON API uchun rasmiy oddiy qo‘llanma. JSON olish uchun ?format=json qo‘shing yoki Accept: application/json yuboring.

Asosiy URL: https://namoz-vaqti.uz/

Hozirgi parametrlar: region=toshkent-shahri lang=lotin period=today

→ Hozirgi sahifa uchun JSON namunasi

So‘rov parametrlari

ParametrTavsifMisol
region (majburiy) Hudud slug-i yoki alias (shahar/viloyat/tuman). Masalan: toshkent, samarqand-shahri, olmazor. To‘liq ro‘yxat frontend selectida ishlatiladiganlar bilan bir xil. ?region=toshkent
lang (ixtiyoriy) UI/label tili: lotin, kirill, ru, en, kk, ky, tg, tk ?lang=lotin
period (ixtiyoriy) Vaqt oralig‘i yoki namoz turi. Qiymatlar:
Oraliqlar: today, week, month, halfyear, year yoki aniq oy YYYY-MM (masalan 2025-11).
Namozlar: inglizcha slug: fajr, dhuhr, asr, maghrib, isha (yoki mos kanonik: bomdod, peshin, asr, shom, xufton).
?period=week, ?period=2025-11
format (ixtiyoriy) json — JSON chiqaradi; docs — shu hujjat sahifasi. ?format=json
json (ixtiyoriy) 1 bo‘lsa, JSON qaytaradi (alternativa sifatida). Masalan, kesh/proksi uchun qulay. ?json=1

Tez start (namunalar)

HTTP Accept: application/json yuborsangiz, ?format=json yozmasdan ham JSON qaytadi.

JSON javob tuzilmasi

{
  "meta": {
    "region": {
      "slug": "toshkent-shahri",
      "name": "Toshkent shahri",
      "parent": "toshkent-shahri"
    },
    "lang": "lotin",
    "period": "today",
    "period_canonical": "today",
    "ym": null,
    "date": "YYYY-MM-DD",
    "now": "HH:MM",
    "offset_min": <integer>,
    "urls": {
      "canonical": "<url>",
      "alternate": { "<lang>": "<url>", ... },
      "default": "<url>"
    }
  },
  "labels": {
    "bomdod": "Bomdod (Saharlik yakuni)",
    "quyosh": "Quyosh",
    "peshin": "Peshin",
    "asr":    "Asr",
    "shom":   "Shom (Iftor vaqti)",
    "xufton": "Xufton"
  },
  "today": {
    "times": {
      "bomdod": "HH:MM",
      "quyosh": "HH:MM",
      "peshin": "HH:MM",
      "asr":    "HH:MM",
      "shom":   "HH:MM",
      "xufton": "HH:MM"
    },
    "current": {
      "key": "<canonical-key> | '''",
      "label": "<localized label> | '''",
      "start": "HH:MM | '''",
      "end":   "HH:MM | '''"
    },
    "next": {
      "key": "<canonical-key> | '''",
      "label": "<localized label> | '''",
      "time": "HH:MM | '''"
    }
  },
  "period_table": [
    {
      "date": "DD.MM.YYYY",
      "times": {
        "bomdod": "HH:MM",
        "quyosh": "HH:MM",
        "peshin": "HH:MM",
        "asr":    "HH:MM",
        "shom":   "HH:MM",
        "xufton": "HH:MM"
      }
    },
    ...
  ]
}

Izohlar:

HTTP javob kodlari

KodMa’nosi
200Muvaffaqiyatli
404Til yoki region topilmadi yoki ma’lumot yo‘q

SEO/Alternativalar

Har bir HTML sahifa rel="alternate" bilan JSON versiyaga type="application/json" ko‘rsatadi. API’ni dasturiy foydalanish uchun to‘g‘ridan-to‘g‘ri ?format=json ni ishlating.