Перейти до вмісту
POST/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_exceptionsbooleanобов’язковий
date_timestring (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_housebooleanобов’язковий
include_lagna_housebooleanобов’язковий
keysarrayобов’язковий

Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.

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.

latitudenumber (double)обов’язковий

Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси.

min -90 · max 90

longitudenumber (double)обов’язковий

Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї.

min -180 · max 180

manglik_reference_planetintegerобов’язковий
moon_starstringобов’язковий

За змістом — НОМЕР накшатри 1–27 (накшатри Ганда Мула: 1 Ашвіні, 9 Ашлеша, 10 Магха, 18 Джйештха, 19 Мула, 27 Реваті). Робочий список допустимих значень неможливо опублікувати, доки не виправлено цю невідповідність типів.

timezonenumber (double)обов’язковий

Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30). Означає те саме, що й timezone_as_float, — інші ендпоінти просто називають це поле інакше.

Доступні ключі (10)

Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.

КлючДодаткові поляОпис
ganda_moolamoon_starГанда Мула: чи належить накшатра народження до шести накшатр на стиках (Ашвіні, Ашлеша, Магха, Джйештха, Мула, Реваті). Ключ мав би приймати номер накшатри 1–27 у `moon_star` і повертати булеве значення, але поле має тип рядка, а список для порівняння містить цілі числа, тож зараз ключ повертає false для будь-якого вхідного значення.
get_dosha_detailsdate_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, коли всі сім класичних планет затиснуті між Раху й Кету по один бік вузлової осі. Повертає одне булеве значення; різновид (Ананта, Куліка, Васукі тощо) залежить від дому, у якому стоїть Раху.
kalathra—Калатра-доша — ураження дому шлюбу. True, коли кожен природний малефік — Сонце, Марс, Сатурн, Раху й Кету — стоїть у 1-му, 2-му, 4-му, 7-му, 8-му чи 12-му домі від сьомого дому. Повертає одне булеве значення; оскільки умову мають виконати всі п’ять малефіків, true трапляється рідко.
manglikmanglik_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. Детальніше — у довіднику помилок.