Перейти к основному содержимому
POST/api/astro/malayalam_calendar/1 кредит

Календарь малаялам

Обрядовые дни Кералы на год по календарю малаялам (эра Коллам). Это солнечный календарь: месяцы начинаются с вхождения Солнца в очередной сидерический знак, а год — с Chingam Sankramam в августе. В список входят двенадцать санкрамам, храмовые праздники и враты Кералы — Thiruvathira, Makaravilakku, Attukal Pongal, Painkuni Uthram, Guruvayur Ekadasi, начало Mandalakala — и общеиндийские дни так, как их соблюдают в Керале. Передайте год, широту, долготу и смещение UTC. Ответ — {year, events}, каждое событие — {name, date}, в порядке дат; обычно за год возвращается около пятидесяти записей. Год должен быть в диапазоне от 2006 до 2046. Онам здесь представлен одной записью с датой. Чтобы получить праздничную неделю по дням, со временем накшатр и номерами дней по календарю малаялам, используйте /api/astro/onam_calendar/.

https://api.occultapi.com/api/astro/malayalam_calendar/
Попробовать запрос
«Календарь малаялам» — результат в интерфейсе
Данные этого эндпоинта в живом интерфейсе. API отдаёт значения, а внешний вид вы делаете сами.

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

ПолеТипОбязательноПримечания
latitudenumber (double)обязательный

Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы.

longitudenumber (double)обязательный

Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае.

timezone_as_floatnumber (double)обязательный

Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение.

yearintegerобязательный

Год рождения числом, например 1990. Четыре цифры.

min 2006 · max 2046

Пример запроса

curl -X POST https://api.occultapi.com/api/astro/malayalam_calendar/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'

Ответ

{
  "data": {
    "year": 2026,
    "events": [
      {
        "name": "Thiruvathira",
        "date": "2026-01-03"
      },
      {
        "name": "Makaram Sankramam",
        "date": "2026-01-14"
      },
      {
        "name": "Pongal",
        "date": "2026-01-14"
      },
      {
        "name": "Makaravilakku",
        "date": "2026-01-14"
      },
      {
        "name": "Thai Pooyam",
        "date": "2026-02-01"
      },
      {
        "name": "Kumbham Sankramam",
        "date": "2026-02-13"
      },
      {
        "name": "Shivarathri",
        "date": "2026-02-15"
      },
      {
        "name": "Attukal Pongal",
        "date": "2026-02-23"
      },
      {
        "name": "Meenam Sankramam",
        "date": "2026-03-15"
      },
      {
        "name": "Matsyavathara Dinam",
        "date": "2026-03-21"
      },
      {
        "name": "Shree Rama Navami *Smarta",
        "date": "2026-03-26"
      },
      {
        "name": "Painkuni Uthram",
        "date": "2026-04-01"
      },
      {
        "name": "Metam Sankramam",
        "date": "2026-04-14"
      },
      {
        "name": "Solar New Year",
        "date": "2026-04-14"
      },
      {
        "name": "Parashurama Jayanthi",
        "date": "2026-04-19"
      },
      {
        "name": "Akshaya Trithiya",
        "date": "2026-04-19"
      },
      {
        "name": "Shree Shankara Jayanthi",
        "date": "2026-04-21"
      },
      {
        "name": "Narasimha Jayanthi",
        "date": "2026-04-30"
      },
      {
        "name": "Chitra Pournami",
        "date": "2026-05-01"
      },
      {
        "name": "Kurmavathara Dinam",
        "date": "2026-05-01"
      },
      {
        "name": "Itavam Sankramam",
        "date": "2026-05-15"
      },
      {
        "name": "Mithunam Sankramam",
        "date": "2026-06-15"
      },
      {
        "name": "Karkatakam Sankramam",
        "date": "2026-07-16"
      },
      {
        "name": "Guru Poornima",
        "date": "2026-07-29"
      },
      {
        "name": "Chingam Sankramam",
        "date": "2026-08-17"
      },
      {
        "name": "Malayalam New Year",
        "date": "2026-08-17"
      },
      {
        "name": "Onam",
        "date": "2026-08-26"
      },
      {
        "name": "Ashtami Rohini",
        "date": "2026-09-04"
      },
      {
        "name": "Varaha Jayanthi",
        "date": "2026-09-13"
      },
      {
        "name": "Kerala Vinayaka Chathurthi",
        "date": "2026-09-14"
      },
      {
        "name": "Rishi Panchami",
        "date": "2026-09-15"
      },
      {
        "name": "Kanni Sankramam",
        "date": "2026-09-17"
      },
      {
        "name": "Vishwakarma Puja",
        "date": "2026-09-17"
      },
      {
        "name": "Vamana Jayanthi",
        "date": "2026-09-23"
      },
      {
        "name": "Navarathri",
        "date": "2026-10-11"
      },
      {
        "name": "Thulam Sankramam",
        "date": "2026-10-17"
      },
      {
        "name": "Durgashtami",
        "date": "2026-10-19"
      },
      {
        "name": "Maha Navami",
        "date": "2026-10-20"
      },
      {
        "name": "Vijayadashami",
        "date": "2026-10-21"
      },
      {
        "name": "Vidyarambham Day",
        "date": "2026-10-21"
      },
      {
        "name": "Diwali",
        "date": "2026-11-08"
      },
      {
        "name": "Vrischikam Sankramam",
        "date": "2026-11-16"
      },
      {
        "name": "Mandalakala Begins",
        "date": "2026-11-16"
      },
      {
        "name": "Guruvayur Ekadasi",
        "date": "2026-11-20"
      },
      {
        "name": "Karthigai Deepam",
        "date": "2026-11-24"
      },
      {
        "name": "Dhanu Sankramam",
        "date": "2026-12-16"
      },
      {
        "name": "Mukkoti Ekadasi",
        "date": "2026-12-20"
      },
      {
        "name": "Geeta Dinam",
        "date": "2026-12-20"
      },
      {
        "name": "Thiruvathira",
        "date": "2026-12-24"
      },
      {
        "name": "Mandalakala Pooja",
        "date": "2026-12-26"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.