curl -X POST https://api.occultapi.com/api/astro/patyayini_dasha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dasha_periods"],"date_time":"2025-02-13T05:07:54.585Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Патьяйини — одна из систем расчёта времени для годовой карты таджика, то есть карты, построенной на момент, когда Солнце каждый год возвращается к своей натальной долготе. Вимшоттари делит время по накшатрам, а Патьяйини делит год по промежуткам между планетами: семь классических планет сортируются по долготе, дуга от каждой до следующей задаёт долю этой планеты, и доли масштабируются так, чтобы в сумме дать ровно один год. Результат показывает, какая планета управляет каким отрезком ближайших двенадцати месяцев и какая планета ведёт каждый подпериод внутри этого отрезка. Один ключ — `get_dasha_periods`. Передайте в `date_time` момент, от которого отсчитывается год, а также `latitude`, `longitude` и `timezone_as_float`. Раху и Кету не участвуют. О структуре ответа стоит знать две вещи. Планеты возвращаются целыми индексами в порядке Солнце, Луна, Марс, Меркурий, Юпитер, Венера, Сатурн, так что 0 — Солнце, а 6 — Сатурн. А время начала подпериодов — это строки с датой, за которой следует словарь в строковом виде, например `"2025-02-13 {'degrees': 5, 'minutes': 7, 'seconds': 54.0}"`; здесь degrees, minutes и seconds — часы, минуты и секунды дня, а не угол. Учитывайте это при разборе.
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| date_time | string (date-time) | обязательный | Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC, и может вернуть результат за предыдущий день со статусом 200. '2026-09-01T06:00:00Z' и '2026-09-01 06:00:00' — разные моменты, и ответы для них будут разными. |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| timezone_as_float | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. min -12 · max 14 |
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание | |
|---|---|---|---|
| get_dasha_periods | — | Полная последовательность Патьяйини на один год: список `[planet, sub_periods, duration]`, по одной записи на каждый основной период. `planet` — целый индекс в порядке Солнце, Луна, Марс, Меркурий, Юпитер, Венера, Сатурн; `duration` — продолжительность периода в днях, в сумме по списку примерно 365.24. `sub_periods` — список из семи пар `[lord, start]`, где `lord` — тот же целый индекс, а `start` — строка вида `"YYYY-MM-DD {'degrees': H, 'minutes': M, 'seconds': S}"`, в которой три числа — часы, минуты и секунды этого дня. |