/api/astro/tamil_calendar/1 кредитТамильский календарь
Тамильский календарь солнечный, а не лунный, и этим он отличается от большинства других региональных календарей из представленных здесь. Месяц начинается в момент вхождения Солнца в новый сидерический знак, поэтому двенадцать месяцев (Chithirai, Vaikasi, Aani, Aadi, Aavani, Purattasi, Aippasi, Karthigai, Margazhi, Thai, Maasi и Panguni) следуют за положением Солнца и каждый год начинаются примерно в одни и те же григорианские даты; Chithirai открывает год около 14 апреля. Первый день месяца определяется по правилу захода Солнца: если ингрессия Солнца приходится на время между восходом и заходом, первым днём считается этот же календарный день, а если после захода — следующий. Календари телугу, маратхи, гуджарати и каннада, напротив, отсчитывают месяцы от новолуния или полнолуния. Передайте `year` вместе с `latitude`, `longitude` и `timezone_as_float`. Восход и заход Солнца, по которым определяется каждый обрядовый день, рассчитываются для этих координат, поэтому при смене места событие может сдвинуться на день. Ответ — `{year, events}` за весь григорианский год, где каждое событие — `{name, date, tamil_month, tamil_day}`, т. е. григорианская дата и положение внутри тамильского месяца. Pongal, Puthandu, Thai Pusam, Masi Magam, Panguni Uthiram, Aadi Perukku, Karadaiyan Nombu, Ayutha Poojai и остальные праздники указаны под своими тамильскими названиями. Часть этих праздников — те же лунные титхи, что рассчитывает основной движок индуистских праздников: их находят по тамильскому названию, а затем дату определяют по их собственному правилу соблюдения (восход Солнца, мадхьяхна, апарахна, нишита, прадоша или пурвахна). Эти данные берутся из заранее рассчитанной таблицы праздников, поэтому эндпоинт ограничен годами 2006-2046. Несколько записей сознательно не включены, чтобы не выдавать догадки за данные: среди них Agni Nakshatram, три даты Avani Avittam для отдельных Вед, Gayathri Japam и Agastya Arghya.
https://api.occultapi.com/api/astro/tamil_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/tamil_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": "Arudra Darshan",
"date": "2026-01-03",
"tamil_month": "Margazhi",
"tamil_day": 19
},
{
"name": "Bhogi Pandigai",
"date": "2026-01-13",
"tamil_month": "Margazhi",
"tamil_day": 29
},
{
"name": "Pongal",
"date": "2026-01-14",
"tamil_month": "Thai",
"tamil_day": 1
},
{
"name": "Mattu Pongal",
"date": "2026-01-15",
"tamil_month": "Thai",
"tamil_day": 2
},
{
"name": "Thai Amavasai",
"date": "2026-01-18",
"tamil_month": "Thai",
"tamil_day": 5
},
{
"name": "Ratha Sapthami",
"date": "2026-01-25",
"tamil_month": "Thai",
"tamil_day": 12
},
{
"name": "Thai Pusam",
"date": "2026-02-01",
"tamil_month": "Thai",
"tamil_day": 19
},
{
"name": "Shivaratri",
"date": "2026-02-15",
"tamil_month": "Maasi",
"tamil_day": 3
},
{
"name": "Masi Magam",
"date": "2026-03-03",
"tamil_month": "Maasi",
"tamil_day": 19
},
{
"name": "Karadaiyan Nombu",
"date": "2026-03-14",
"tamil_month": "Maasi",
"tamil_day": 30
},
{
"name": "Ugadi - Telugu New Year",
"date": "2026-03-19",
"tamil_month": "Panguni",
"tamil_day": 5
},
{
"name": "Rama Navami *Smarta",
"date": "2026-03-26",
"tamil_month": "Panguni",
"tamil_day": 12
},
{
"name": "Panguni Uthiram",
"date": "2026-04-01",
"tamil_month": "Panguni",
"tamil_day": 18
},
{
"name": "Puthandu",
"date": "2026-04-14",
"tamil_month": "Chithirai",
"tamil_day": 1
},
{
"name": "Vishu",
"date": "2026-04-15",
"tamil_month": "Chithirai",
"tamil_day": 2
},
{
"name": "Akshaya Thiruthiyai",
"date": "2026-04-19",
"tamil_month": "Chithirai",
"tamil_day": 6
},
{
"name": "Sankara Jayanthi",
"date": "2026-04-21",
"tamil_month": "Chithirai",
"tamil_day": 8
},
{
"name": "Ramanuja Jayanthi",
"date": "2026-04-22",
"tamil_month": "Chithirai",
"tamil_day": 9
},
{
"name": "Chitra Pournami",
"date": "2026-05-01",
"tamil_month": "Chithirai",
"tamil_day": 18
},
{
"name": "Vaikasi Visakam",
"date": "2026-05-30",
"tamil_month": "Vaikasi",
"tamil_day": 16
},
{
"name": "Aadi Perukku",
"date": "2026-08-03",
"tamil_month": "Aadi",
"tamil_day": 18
},
{
"name": "Aadi Amavasai",
"date": "2026-08-12",
"tamil_month": "Aadi",
"tamil_day": 27
},
{
"name": "Andal Jayanthi",
"date": "2026-08-14",
"tamil_month": "Aadi",
"tamil_day": 29
},
{
"name": "Gokulastami",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Astami Rohini",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Vinayagar Chathurthi",
"date": "2026-09-14",
"tamil_month": "Aavani",
"tamil_day": 29
},
{
"name": "Mahalaya Amavasai",
"date": "2026-10-10",
"tamil_month": "Purattasi",
"tamil_day": 24
},
{
"name": "Navarathiri",
"date": "2026-10-11",
"tamil_month": "Purattasi",
"tamil_day": 25
},
{
"name": "Ayutha Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Saraswati Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vijaya Dashami",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vidyarambham",
"date": "2026-10-21",
"tamil_month": "Aippasi",
"tamil_day": 4
},
{
"name": "Lakshmi Puja",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Kedara Gowri Vratham",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Deepavali",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Karthigai Deepam",
"date": "2026-11-24",
"tamil_month": "Karthigai",
"tamil_day": 8
},
{
"name": "Subrahmanya Sashti",
"date": "2026-12-15",
"tamil_month": "Karthigai",
"tamil_day": 29
},
{
"name": "Vaikuntha Ekadashi",
"date": "2026-12-20",
"tamil_month": "Margazhi",
"tamil_day": 5
},
{
"name": "Arudra Darshan",
"date": "2026-12-24",
"tamil_month": "Margazhi",
"tamil_day": 9
}
]
},
"message": "successful",
"is_error": false
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.