/api/astro/dosha/1 кредитДоши
Доша — это определённое поражение в натальной карте: именованная планетарная конфигурация, которую классические тексты считают неблагоприятной, чаще всего для брака, здоровья или родовой линии. Этот эндпоинт проверяет восемь дош по моменту и месту рождения и может вернуть либо сами результаты, либо готовые к показу текстовые пояснения. Пользоваться им можно двумя способами. Отдельные ключи (`kala_sarpa`, `manglik`, `pitru_dosha` и остальные) возвращают структурированные результаты, с которыми удобно работать в коде. `get_dosha_details` возвращает весь набор в виде отформатированных HTML-абзацев с ключами по английским названиям дош — это удобно, если вы выводите отчёт; он охватывает кала-сарпу, мангалик-дошу, питру-дошу, гуру-чандалу, калатра-дошу, гхата-дошу и шрапит-дошу, но не ганда-мулу. `get_dosha_resources` отдаёт исходный корпус текстов, если вы хотите составлять текст сами. Сериализатор требует все булевы и структурированные поля запроса, даже для ключей, которые их игнорируют. `manglik_reference_planet` — индекс планеты (0 Солнце, 1 Луна, 2 Марс, 3 Меркурий, 4 Юпитер, 5 Венера, 6 Сатурн, 7 Раху, 8 Кету); значение по умолчанию в самом движке — отсчёт от асцендента — через API выбрать нельзя, потому что поле объявлено целочисленным. На этом эндпоинте поле смещения UTC называется `timezone`, а не `timezone_as_float`.
https://api.occultapi.com/api/astro/dosha/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| apply_exceptions | boolean | обязательный | |
| 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' — разные моменты, и ответы для них будут разными. Ограничение ФОРМАТА. DRF DateTimeField: только ISO-8601 (входные форматы DRF по умолчанию), например "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" или "2026-09-01 06:00:00" (без часового пояса подразумевается UTC). |
| include_2nd_house | boolean | обязательный | |
| include_lagna_house | boolean | обязательный | |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsМассив строк. 'manglik' требует manglik_reference_planet, include_lagna_house, include_2nd_house и apply_exceptions; 'ganda_moola' требует moon_star; 'get_dosha_details' требует date_time и geopos. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| manglik_reference_planet | integer | обязательный | |
| moon_star | string | обязательный | По смыслу — НОМЕР накшатры 1-27 (накшатры ганда-мулы: 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Пока это несоответствие типов не исправлено, рабочий список допустимых значений опубликовать нельзя. |
| timezone | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30). По смыслу совпадает с timezone_as_float: другие эндпоинты называют это поле иначе. |
Доступные ключи (10)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| ganda_moola | moon_star | Ганда-мула: является ли накшатра рождения одной из шести стыковых накшатр (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). Ключ должен принимать номер накшатры 1–27 в `moon_star` и возвращать булево значение, но поле объявлено строковым, а в списке для сравнения — целые числа, поэтому сейчас ключ возвращает false при любых входных данных. |
| get_dosha_details | date_time, geopos | Все семь дош с текстовыми описаниями — проверка и пояснения за один раз: объект с ключами по английским названиям дош — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha и Shrapit Dosha; значения — HTML-фрагменты о том, есть ли доша и что она означает. Ганда-мула не входит. Нужны `date_time` и место. |
| get_dosha_resources | — | Полный корпус пояснительных текстов о дошах — объект с ключами по названиям дош ('kala_sarpa', 'manglik', 'pitru', 'ghata' и т. д.), у каждой — список абзацев на английском языке. Первый элемент списка — формулировка «такой доши нет», следующие соответствуют затронутому дому или разновидности. Подходит, если вы хотите выводить собственный текст, а не готовый HTML. |
| ghata | — | Гхата-доша: Марс и Сатурн вместе в одном знаке. Возвращает одно булево значение. |
| guru_chandala_dosha | — | Гуру-чандала: Юпитер в соединении с Раху или Кету в одном знаке. Возвращает список из двух элементов: [присутствует ли сочетание, сильнее ли Юпитер из двух]. Оба равны false, если соединения нет. |
| kala_sarpa | — | Кала-сарпа-доша: true, если все семь классических планет зажаты между Раху и Кету по одну сторону узловой оси. Возвращает одно булево значение; разновидность (Ananta, Kulika, Vasuki и т. д.) определяется домом, в котором находится Раху. |
| kalathra | — | Калатра-доша — поражение дома брака. Равно true, если каждая естественно неблаготворная планета — Солнце, Марс, Сатурн, Раху и Кету — находится в 1-м, 2-м, 4-м, 7-м, 8-м или 12-м доме при отсчёте от седьмого дома. Возвращает одно булево значение; так как условие должно выполняться для всех пяти неблаготворных планет, true бывает редко. |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | Мангалик-доша (мангал-доша): находится ли Марс в одном из домов, неблагоприятных для брака, при отсчёте от `manglik_reference_planet`. Возвращает список из трёх элементов: [мангалик ли, действует ли отмена, номера сработавших правил отмены]. Проверяются 4-й, 7-й, 8-й и 12-й дома, а также 2-й, если `include_2nd_house` равно true, и 1-й, если `include_lagna_house` равно true; отмены проверяются, только если `apply_exceptions` равно true. |
| pitru_dosha | — | Питру-доша — поражение родовой линии. Возвращает список из двух элементов: [true или false, номера сработавших правил]. По порядку проверяются пять правил: светило или Раху в 9-м доме, Кету в 4-м, Солнце/Луна/Раху/Кету поражены Марсом или Сатурном, скопление Меркурия, Венеры и Раху во 2-м, 5-м, 9-м или 12-м и Солнце или Луна в соединении с узлом. |
| shrapit | — | Шрапит-доша: Сатурн и Раху вместе в одном знаке. Возвращает одно булево значение. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'Ответ
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.