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

Календар ISKCON

Вайшнавський календар, за яким живе ISKCON: повний рік екадаші, дні явлення та відходу ачар’їв і головні свята, датовані за гаудія-ліком, а не за загальноіндуїстським. Місяці названо дванадцятьма іменами Вішну — Madhava, Govinda, Damodara та інші, — дві пакші звуться Krishna і Gaura, а роки лічать за ерою Гаурабда. Передайте рік разом із latitude, longitude і зміщенням від UTC: на який цивільний день припадає обряд, визначає тітхі, чинна на момент місцевого сходу Сонця. Відповідь — {year, events}, кожна подія — {name, date, masa, paksa, tithi_number, is_adhika, gaurabda_year}, тож ви отримуєте і григоріанську дату, і вайшнавські координати, з яких її обчислено; is_adhika позначає подію в адхіка-місяці. Тітхі й місяці обчислюються за специфікацією GCAL, на якій працює власна календарна програма ISKCON. Це свідомо не той метод на основі сидеричних ефемерид, що стоїть за /api/astro/panchanga/, тож дати можуть на день відрізнятися від інших ендпоінтів цього API. За рік повертається кілька сотень подій, тому фільтруйте їх або розбивайте на сторінки на боці клієнта.

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

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

Результат «Календар ISKCON» в інтерфейсі — Дані цього ендпоінта в живому інтерфейсі. 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 1800 · max 2400

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/iskcon_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\": \"Shri Krishna Pushya Abhisheka\", \"date\": \"2026-01-03\", \"masa\": \"Narayana\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Ramachandra Kaviraja - Disappearance\", \"date\": \"2026-01-07\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Gopala Bhatta Goswami - Appearance\", \"date\": \"2026-01-07\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Jayadeva Goswami - Disappearance\", \"date\": \"2026-01-08\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 6, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Lochana Dasa Thakura - Disappearance\", \"date\": \"2026-01-09\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 7, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shat Tila Ekadashi\", \"date\": \"2026-01-14\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 11, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Sarasvati Puja\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Pundarika Vidyanidhi - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Raghunandana Thakura - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Raghunatha Dasa Goswami - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Vishwanatha Chakravarti Thakura - Disappearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrimati Vishnupriya Devi - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Vasanta Panchami\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Advaita Acharya - Appearance\", \"date\": \"2026-01-25\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 7, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Bhishmashtami\", \"date\": \"2026-01-26\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 8, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Madhvacharya - Disappearance\", \"date\": \"2026-01-27\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 9, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Ramanujacharya - Disappearance\", \"date\": \"2026-01-28\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 10, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Bhaimi Ekadashi\", \"date\": \"2026-01-29\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 11, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Varaha Dwadashi\", \"date\": \"2026-01-30\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 12, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Nityananda Trayodashi\", \"date\": \"2026-01-31\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 13, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Krishna Madhura Utsava\", \"date\": \"2026-02-01\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Narottama Dasa Thakura - Appearance\", \"date\": \"2026-02-01\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Purushottama Dasa Thakura - Disappearance\", \"date\": \"2026-02-06\", \"masa\": \"Govinda\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Bhaktisiddhanta Sarasvati Thakura - Appearance\", \"date\": \"2026-02-06\", \"masa\": \"Govinda\", \"paksa\": \"Krishna\", \"tithi_"
}

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

Помилки

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