POST/api/astro/kannada_calendar/1 кредит

Календар каннада

Рік свят і обрядів, як їх відзначають у Карнатаці. Календар каннада — місячно-сонячний, аманта, з ліком за ерою Шака (місяць триває від одного молодика до наступного). До набору свят входять екадаші, дванадцять санкранті, затемнення та регіональні дні: Yugadi, Gowri Habba, Kamanahabba, свято Karaga, Sakat і Karwa Chauth. Передайте year разом із latitude, longitude і зміщенням від UTC. Місце важливе, бо дати низки обрядів визначає тітхі на момент сходу Сонця або схід Місяця. Відповідь — {year, events}, кожна подія — {name, date}, у порядку дат; зазвичай це значно більше сотні записів. Рядки затемнень мають суфікс типу, напр. 'Surya Grahan *Valayakara'. Рік має бути в межах від 2006 до 2046.

https://api.occultapi.com/api/astro/kannada_calendar/

Спробувати запит

Результат «Календар каннада» в інтерфейсі — Дані цього ендпоінта в живому інтерфейсі. API повертає значення, а вигляд сторінки ви будуєте самі.

Автентифікація

Передавайте ключ у заголовку 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/kannada_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\": \"Sakat Chauth\", \"date\": \"2026-01-06\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Makara Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Pongal\", \"date\": \"2026-01-14\"}, {\"name\": \"Mauni Amavas\", \"date\": \"2026-01-18\"}, {\"name\": \"Vasant Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Ratha Saptami\", \"date\": \"2026-01-25\"}, {\"name\": \"Bhishma Ashtami\", \"date\": \"2026-01-26\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Kumbha Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi Hunnime\", \"date\": \"2026-03-03\"}, {\"name\": \"Kamanahabba\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-04\"}, {\"name\": \"Sheetala Ashtami\", \"date\": \"2026-03-11\"}, {\"name\": \"Basoda\", \"date\": \"2026-03-11\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Meena Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Nutan Varsh Prarambha\", \"date\": \"2026-03-19\"}, {\"name\": \"Gudi Padwa\", \"date\": \"2026-03-19\"}, {\"name\": \"Chaitra Navratri\", \"date\": \"2026-03-19\"}, {\"name\": \"Yugadi\", \"date\": \"2026-03-19\"}, {\"name\": \"Gauri Puja\", \"date\": \"2026-03-21\"}, {\"name\": \"Soubhagya Gauri Vrat\", \"date\": \"2026-03-21\"}, {\"name\": \"Yamuna Chhath\", \"date\": \"2026-03-24\"}, {\"name\": \"Shri Rama Navami\", \"date\": \"2026-03-26\"}, {\"name\": \"Swaminarayan Jayanti\", \"date\": \"2026-03-27\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Karaga Festival\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Jayanti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Mesha Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Solar New Year\", \"date\": \"2026-04-14\"}, {\"name\": \"Parashurama Jayanti\", \"date\": \"2026-04-19\"}, {\"name\": \"Akshaya Tritiya\", \"date\": \"2026-04-19\"}, {\"name\": \"Ganga Saptami\", \"date\": \"2026-04-23\"}, {\"name\": \"Sita Navami\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Narasimha Jayanti\", \"date\": \"2026-04-30\"}, {\"name\": \"Buddha Purnima\", \"date\": \"2026-05-01\"}, {\"name\": \"Narada Jayanti\", \"date\": \"2026-05-02\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Vrishabha Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Vat Savitri Vrat\", \"date\": \"2026-05-16\"}, {\"name\": \"Shani Jayanti\", \"date\": \"2026-05-16\"}, {\"name\": \"Ganga Dussehra\", \"date\": \"2026-05-25\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Mithuna Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Vat Purnima Vrat\", \"date\": \"2026-06-29\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Karka Sankranti\", \"date\": \"2026-07-16\"}, {\"name\": \"Jagannath Rathyatra\", \"date\": \"2026-07-16\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Guru Purnima\", \"date\": \"2026-07-29\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Hariyali Teej\", \"date\": \"2026-08-15\"}, {\"name\": \"Simha Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Nagara Panchami\", \"date\": \"2026-08-17\"}, {\"name\": \"Shravana Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Onam\", \"date\": \"2026-08-26\"}, {\"name\": \"Varalakshmi Vrat\", \"date\": \"2026-08-28\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Raksha Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Gayatri Jayanti\", \"date\": \"2026-08-28\"}, {\"name\": \"Kajari Teej\", \"date\": \"2026-08-31\"}, {\"name\": \"Krishna Janmashtami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Gowri Habba\", \"date\": \"2026-09-14\"}, "
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

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