/api/astro/tithi_scan/1 кредитПоиск титхи за год
Титхи — одна тридцатая лунного месяца: время, за которое элонгация Луны относительно Солнца увеличивается ещё на 12 градусов. Почти все индуистские обрядовые дни определяются по титхи, а титхи не совпадают с календарными днями: она может длиться всего около девятнадцати часов или до двадцати шести, поэтому одно её наступление часто приходится на две даты. Эндпоинт принимает одну конкретную титхи и возвращает все её наступления за календарный год с истинными моментами начала и конца. `tithi_number` принимает значения от 1 до 30: 1-15 — от Shukla Pratipada до Purnima, 16-29 — от Krishna Pratipada до Chaturdashi, 30 — Amavasya. `year` — местный календарный год, а `timezone_as_float` определяет, какой именно это год по местному времени (5.5 для IST). Координаты не нужны: титхи начинается и заканчивается в один и тот же момент по всей Земле. Ответ — `{year, tithi_number, rows}`, где `rows` — список меток времени `{start, end}` в формате ISO в UTC в хронологическом порядке; обычно двенадцать или тринадцать записей, поскольку каждая титхи повторяется раз в лунный месяц. Окна не разбиваются на промежуточных восходах Солнца, поэтому наступление, которое захватывает два календарных дня, возвращается одной строкой.
https://api.occultapi.com/api/astro/tithi_scan/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| timezone_as_float | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. |
| tithi_number | integer | обязательный | min 1 · max 30 |
| year | integer | обязательный | Год рождения числом, например 1990. Четыре цифры. min 1800 · max 2400 |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/tithi_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"timezone_as_float":5.5,"tithi_number":1,"year":2026}'Ответ
{
"data": {
"year": 2026,
"tithi_number": 1,
"rows": [
{
"start": "2026-01-18T19:52:39+00:00",
"end": "2026-01-19T20:45:19+00:00"
},
{
"start": "2026-02-17T12:01:47+00:00",
"end": "2026-02-18T11:28:41+00:00"
},
{
"start": "2026-03-19T01:24:05+00:00",
"end": "2026-03-19T23:23:24+00:00"
},
{
"start": "2026-04-17T11:52:21+00:00",
"end": "2026-04-18T08:41:36+00:00"
},
{
"start": "2026-05-16T20:01:32+00:00",
"end": "2026-05-17T16:11:46+00:00"
},
{
"start": "2026-06-15T02:54:39+00:00",
"end": "2026-06-15T23:01:51+00:00"
},
{
"start": "2026-07-14T09:44:04+00:00",
"end": "2026-07-15T06:21:58+00:00"
},
{
"start": "2026-08-12T17:37:11+00:00",
"end": "2026-08-13T15:12:30+00:00"
},
{
"start": "2026-09-11T03:27:28+00:00",
"end": "2026-09-12T02:17:22+00:00"
},
{
"start": "2026-10-10T15:50:36+00:00",
"end": "2026-10-11T16:02:05+00:00"
},
{
"start": "2026-11-09T07:02:42+00:00",
"end": "2026-11-10T08:31:14+00:00"
},
{
"start": "2026-12-09T00:52:31+00:00",
"end": "2026-12-10T03:17:14+00:00"
}
]
},
"message": "successful",
"is_error": false
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.