/api/astro/malayalam_calendar/1 кредитКалендар малаялам
Рік обрядів Керали за сонячним календарем малаялам (ера Коллам): місяці починаються зі входу Сонця в кожен сидеричний знак, а рік відкривається Chingam Sankramam у серпні. До списку входять дванадцять санкрамамів, храмові свята й врати Керали — Thiruvathira, Makaravilakku, Attukal Pongal, Painkuni Uthram, Guruvayur Ekadasi, початок Mandalakala — та загальноіндійські дні в тому вигляді, як їх відзначають у Кералі. Передайте year разом із latitude, longitude і зміщенням від UTC. Відповідь — {year, events}, кожна подія — {name, date}, у порядку дат; за типовий рік повертається близько п’ятдесяти записів. Рік має бути в межах від 2006 до 2046. Onam тут подано одним записом із датою. Щоб отримати святковий тиждень по днях, із часами накшатр і номерами днів за календарем малаялам, використовуйте /api/astro/onam_calendar/.
https://api.occultapi.com/api/astro/malayalam_calendar/
Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. |
| year | integer | обов’язковий | Рік народження числом, напр. 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. Детальніше — у довіднику помилок.