/api/astro/telugu_calendar/1 кредитКалендар телугу
Календар телугу — місячно-сонячний за системою аманта: місяці тривають від одного молодика до наступного й мають назви телугу (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu і Phalgunamu), а роки лічать за Шака Самват, і рік починається з Ugadi на Chaithramu Shukla Padyami. Арифметика місяців, зокрема визначення адхіка-місяця, та сама, що й у календарях маратхі й каннада: ці три календарі відрізняються назвами місяців і списком свят, а не астрономією. Сонячної схеми переходу від знака до знака, як у тамільському календарі й календарі малаялам, тут немає. Надішліть `year` разом із `latitude`, `longitude` і `timezone_as_float`. Відповідь — `{year, events}`, і кожна подія — це лише `{name, date}`; на відміну від тамільського календаря, полів місяця чи дня місяця тут немає. Очікуйте близько дев’яноста записів на рік: двадцять чотири екадаші (двадцять шість в адхіка-рік) під назвами телугу разом із варіантами Gauna і Vaishnava на наступний день, яких немає в більшості інших регіональних календарів, приблизно двадцять п’ять Pradosh Vrat, названих за днями тижня (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), дванадцять Sankashtahara Chaturthi, дванадцять врат Shukla Dwadashi та основні свята. Схід і захід Сонця та вікно прадоші обчислюються для надісланих координат, тож в іншому місті дата може зсунутися на день; зокрема, правило Pradosh Vrat відносить кожну трайодаші до того цивільного дня, з вікном прадоші якого (після заходу Сонця) вона перетинається найбільше. Свята, спільні з основним індуським календарем, беруться з попередньо обчисленої таблиці, яка охоплює лише 2006-2046.
https://api.occultapi.com/api/astro/telugu_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/telugu_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}'Відповідь
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"events\": [{\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Lambodara Sankashtahara\", \"date\": \"2026-01-06\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Bhishma Dwadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Dwijapriya Sankashtahara\", \"date\": \"2026-02-05\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Trayodashi\", \"date\": \"2026-02-14\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Narasimha Dwadashi\", \"date\": \"2026-02-28\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chhoti Holi\", \"date\": \"2026-03-03\"}, {\"name\": \"Holika Dahan\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-04\"}, {\"name\": \"Bhalachandra Sankashtahara\", \"date\": \"2026-03-06\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ugadi\", \"date\": \"2026-03-19\"}, {\"name\": \"Dola Gowri Vratam\", \"date\": \"2026-03-21\"}, {\"name\": \"Andolana Trutiya\", \"date\": \"2026-03-21\"}, {\"name\": \"Shree Ramanavami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Vamana Dwadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Madana Pournami\", \"date\": \"2026-04-02\"}, {\"name\": \"Vikata Sankashtahara\", \"date\": \"2026-04-05\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Akshaya Trutiya\", \"date\": \"2026-04-19\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Parashurama Dwadashi\", \"date\": \"2026-04-28\"}, {\"name\": \"Ekadanta Sankashtahara\", \"date\": \"2026-05-05\"}, {\"name\": \"Hanuman Jayanthi\", \"date\": \"2026-05-12\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Adhika Ramalakshmana Dwadashi\", \"date\": \"2026-05-27\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Vibhuvana Sankashtahara\", \"date\": \"2026-06-03\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Ramalakshmana Dwadashi\", \"date\": \"2026-06-26\"}, {\"name\": \"Shani Trayodashi\", \"date\": \"2026-06-27\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Krishnapingala Sankashtahara\", \"date\": \"2026-07-03\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Vaishnava Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Vasudeva Dwadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Gajanana Sankashtahara\", \"date\": \"2026-08-02\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Shravana Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Vaishnava Shravana Putrada Ekadashi\", \"date\": \"2026-08-24\"}, {\"name\": \"Damodara Dwadashi\", \"date\": \"2026-08-24\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Varalakshmi Vratam\", \"date\": \"2026-08-28\"}, {\"name\": \"Raksha Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Heramba Sankashtahara\", \"date\": \"2026-08-31\"}, {\"name\": \"Krishna Janmashtami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Parivartani Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Kalki Dwadashi\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\":"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.