POSThttps://api.occultapi.com/api/astro/dosha/

Доші

Тіло запитуJSON

Щоб надіслати запит, вставте API-ключ вище.

Фрагмент коду

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"}'

Доша — це певне ураження в натальній карті: конкретна планетна конфігурація, яку класичні тексти вважають вадою, найчастіше щодо шлюбу, здоров’я чи роду. Цей ендпоінт перевіряє вісім таких дош за моментом і місцем народження і повертає або самі результати, або готові до показу текстові пояснення. Використовувати його можна двома способами. Окремі ключі (`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`.

Поля запиту

Поле	Тип	Обов’язкове	Примітки
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 Ашвіні, 9 Ашлеша, 10 Магха, 18 Джйештха, 19 Мула, 27 Реваті). Робочий список допустимих значень неможливо опублікувати, доки не виправлено цю невідповідність типів.
timezone	number (double)	обов’язковий	Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30). Означає те саме, що й timezone_as_float, — інші ендпоінти просто називають це поле інакше.

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

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

Ключ	Додаткові поля	Опис
ganda_moola	moon_star	Ганда Мула: чи належить накшатра народження до шести накшатр на стиках (Ашвіні, Ашлеша, Магха, Джйештха, Мула, Реваті). Ключ мав би приймати номер накшатри 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, коли всі сім класичних планет затиснуті між Раху й Кету по один бік вузлової осі. Повертає одне булеве значення; різновид (Ананта, Куліка, Васукі тощо) залежить від дому, у якому стоїть Раху.
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	—	Шрапіт-доша: Сатурн і Раху разом в одному знаку. Повертає одне булеве значення.

Повний довідник цього ендпоінта