/api/astro/onam_calendar/1 кредитКалендарь Онама
Онам — не один день, а череда дней, привязанных к идущим подряд накшатрам: от Atham (Hasta) через Thiruvonam до Chathayam. Этот эндпоинт возвращает весь этот период для заданного года, по строке на каждый календарный день. В каждой строке указаны day_number, григорианская дата, день недели на английском и письмом малаялам, управляющая накшатра, месяц и день по календарю малаялам с годом эры Коллам, список captions с тем, что отмечают в этот день (Atthachamayam, Athapoo Pookalam, Vallam Kali и так далее), флаг is_repeat_day и segments с точными моментами начала и конца накшатры по местному времени. Число дней не фиксировано. Если накшатра длится так долго, что захватывает два восхода, появляется повторный день — с тем же названием, пустым captions и null вместо начала и конца, — и череда удлиняется. Короткая накшатра, наоборот, может слиться со следующим днём, и тогда в его captions будут два названия. Обычно получается двенадцать или тринадцать строк. Передайте год, широту, долготу и смещение UTC; год должен быть в диапазоне от 2006 до 2046. Если нужен Онам одной записью с датой среди всех праздников Кералы за год, используйте /api/astro/malayalam_calendar/.
https://api.occultapi.com/api/astro/onam_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/onam_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, \"days\": [{\"day_number\": 1, \"date\": \"2026-08-16\", \"weekday_en\": \"Sunday\", \"weekday_ml\": \"ഞായറാഴ്ച\", \"nakshatra\": \"Atham\", \"malayalam_month\": \"Karkatakam\", \"malayalam_day\": 31, \"kollam_year\": 1201, \"captions\": [\"Atthachamayam\", \"Athapoo Pookalam\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Atham\", \"begin\": \"2026-08-16T03:25:45+05:30\", \"end\": \"2026-08-17T03:50:52+05:30\"}]}, {\"day_number\": 2, \"date\": \"2026-08-17\", \"weekday_en\": \"Monday\", \"weekday_ml\": \"തിങ്കളാഴ്ച\", \"nakshatra\": \"Chithira\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 1, \"kollam_year\": 1202, \"captions\": [\"Chithira Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Chithira\", \"begin\": \"2026-08-17T03:50:52+05:30\", \"end\": \"2026-08-18T04:58:59+05:30\"}]}, {\"day_number\": 3, \"date\": \"2026-08-18\", \"weekday_en\": \"Tuesday\", \"weekday_ml\": \"ചൊവ്വാഴ്ച\", \"nakshatra\": \"Chothi\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 2, \"kollam_year\": 1202, \"captions\": [\"Chodhi Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Chothi\", \"begin\": \"2026-08-18T04:58:59+05:30\", \"end\": \"2026-08-19T06:47:04+05:30\"}]}, {\"day_number\": 4, \"date\": \"2026-08-19\", \"weekday_en\": \"Wednesday\", \"weekday_ml\": \"ബുധനാഴ്ച\", \"nakshatra\": \"Vishakham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 3, \"kollam_year\": 1202, \"captions\": [\"Vishakham Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Vishakham\", \"begin\": \"2026-08-19T06:47:04+05:30\", \"end\": \"2026-08-20T09:08:29+05:30\"}]}, {\"day_number\": 5, \"date\": \"2026-08-20\", \"weekday_en\": \"Thursday\", \"weekday_ml\": \"വ്യാഴാഴ്ച\", \"nakshatra\": \"Vishakham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 4, \"kollam_year\": 1202, \"captions\": [], \"is_repeat_day\": true, \"segments\": [{\"name\": \"Vishakham\", \"begin\": null, \"end\": null}]}, {\"day_number\": 6, \"date\": \"2026-08-21\", \"weekday_en\": \"Friday\", \"weekday_ml\": \"വെള്ളിയാഴ്ച\", \"nakshatra\": \"Anizham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 5, \"kollam_year\": 1202, \"captions\": [\"Anizham Day\", \"Vallam Kali\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Anizham\", \"begin\": \"2026-08-20T09:08:29+05:30\", \"end\": \"2026-08-21T11:53:15+05:30\"}]}, {\"day_number\": 7, \"date\": \"2026-08-22\", \"weekday_en\": \"Saturday\", \"weekday_ml\": \"ശനിയാഴ്ച\", \"nakshatra\": \"Thrikketta\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 6, \"kollam_year\": 1202, \"captions\": [\"Thriketa Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Thrikketta\", \"begin\": \"2026-08-21T11:53:15+05:30\", \"end\": \"2026-08-22T14:49:28+05:30\"}]}, {\"day_number\": 8, \"date\": \"2026-08-23\", \"weekday_en\": \"Sunday\", \"weekday_ml\": \"ഞായറാഴ്ച\", \"nakshatra\": \"Moolam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 7, \"kollam_year\": 1202, \"captions\": [\"Moolam Day, Onam Sadya\", \"Puli Kali, Kaikotti Kali\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Moolam\", \"begin\": \"2026-08-22T14:49:28+05:30\", \"end\": \"2026-08-23T17:44:53+05:30\"}]}, {\"day_number\": 9, \"date\": \"2026-08-24\", \"weekday_en\": \"Monday\", \"weekday_ml\": \"തിങ്കളാഴ്ച\", \"nakshatra\": \"Pooradam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 8, \"kollam_year\": 1202, \"captions\": [\"Pooradam Day, Onathappan\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Pooradam\", \"begin\": \"2026-08-23T17:44:53+05:30\", \"end\": \"2026-08-24T20:28:27+05:30\"}]}, {\"day_number\": 10, \"date\": \"2026-08-25\", \"weekday_en\": \"Tuesday\", \"weekday_ml\": \"ചൊവ്വാഴ്ച\", \"nakshatra\": \"Uthradam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 9, \"kollam_year\": 1202, \"captions\": [\"Uthradom Day, First Onam\", \"Uthradappachil\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Uthradam\", \"begin\": \"2026-08-24T20:28:27+05:30\", \"end\": \"2026-08-25T22:51:30+05:30\"}]}, {\"day_number\": 11, \"date\": \"2026-08-26\", \"weekday_en\": \"Wednesday\", \"weekday_ml\": \"ബുധനാഴ്ച\", \"nakshatra\": \"Thiruvonam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 10, \"kollam_year\": 1202, \"captions\": [\"Thiruvonam Day, Second Onam\", \"Thiru-Onam, Onam\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Thiruvonam\", \"begin\": \"2026-08-25T22:51:30+05:30\", \"end\": \"2026-08-27T00:48:15+05:3"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.