/api/astro/nepali_calendar/1 кредитНепальський календар
Рік непальських свят і обрядів за календарем Бікрам Самбат. Непальський календар сонячний: дванадцять місяців, кожен починається зі входу Сонця в сидеричний знак, першим іде Baishakh. Відповідь містить рік або пару років Бікрам Самбат, на які припадає запитаний григоріанський рік. До списку подій входять усі санкранті під непальськими назвами (Maghe, Falgun, Baishakh тощо), усі екадаші, обидва Pradosh Vrat кожного місяця з назвами за днем тижня, затемнення та національні свята, як-от Nawa Barsha і Bisket Jatra. Передайте year разом із latitude, longitude і зміщенням від UTC. Зверніть увагу: стандартний час Непалу — UTC+05:45, тож timezone_as_float для Катманду має бути 5.75; зі значенням 5.5 межі днів зсунуться. Відповідь — {year, bikram_sambat, events}, кожна подія — {name, date}. Рік має бути в межах від 2006 до 2046. Початок місяця визначається за усталеною практикою: санкранті датують днем транзиту, якщо транзит відбувається до заходу Сонця цього дня, а інакше — наступним днем. Офіційні дати початку місяців у Непалі встановлює комітет, а не один астрономічний критерій, тож кілька транзитів на десятиліття не збігатимуться з опублікованим Patro.
https://api.occultapi.com/api/astro/nepali_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/nepali_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, \"bikram_sambat\": \"2082 - 2083\", \"events\": [{\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Maghe Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Sat-Tila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Shree Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Bhima Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Falgun Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Fagu Poornima\", \"date\": \"2026-03-03\"}, {\"name\": \"Chaitra Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ram Nawami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Hanuman Jayenti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Baruthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Baishakh Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Nawa Barsha\", \"date\": \"2026-04-14\"}, {\"name\": \"Bisket Jatra\", \"date\": \"2026-04-14\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Parasuram Jayenti\", \"date\": \"2026-04-19\"}, {\"name\": \"Aachya Tritiya\", \"date\": \"2026-04-20\"}, {\"name\": \"Sita Jayanti\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Buddha Jayanti\", \"date\": \"2026-05-01\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Jeshta Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Asar Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Shrawane Sankranti\", \"date\": \"2026-07-17\"}, {\"name\": \"Harisayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Bhadra Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Janai Purnima\", \"date\": \"2026-08-28\"}, {\"name\": \"Kwati Punhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakshya Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Gai Jatra\", \"date\": \"2026-08-29\"}, {\"name\": \"Shree Krishna Janmastami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Rishi Panchami\", \"date\": \"2026-09-15\"}, {\"name\": \"Ashoj Sankranti\", \"date\": \"2026-09-17\"}, {\"name\": \"Bishwakarma Pooja\", \"date\": \"2026-09-17\"}, {\"name\": \"Radhastami\", \"date\": \"2026-09-19\"}, {\"name\": \"Hari-Parivartan Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Indra Jatra\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-09-24\"}, {\"name\": \"Pitrupaksha Arambha\", \"date\": \"2026-09-27\"}, {\"name\": \"Pratiprada Shradham\", \"date\": \"2026-09-27\"}, {\"name\": \"Indira Ekadashi\", \"date\": \"2026-10-06\"}, {\"name\": \"Guru "
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.