/api/astro/house_hora/1 кредитЗв’язки між домами
Зв’язки всередині натальної карти: які знаки аспектують які, які планети аспектують які, хто кому друг і які планети класичні тексти виділяють як значущі для поворотних моментів карти. Це значна частина інструментарію, на якому будуються судження Джаймині та парашарської астрології, — у вигляді окремих ключів. Ключі поділяються на три групи. Ключі груп домів (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) — чиста геометрія: дванадцять рядків, по одному на знак, із номерами знаків від 1 до 12, і від карти вони не залежать. Ключі аспектів і зв’язків (`raasi_drishti_of_the_planet`, три ключі `aspected_*_of_the_planet`, два ключі `*_of_the_raasi`, `argala`, `associations_of_the_planet`, три ключі природної дружби та `baadhakas_of_raasi`) описують взаємне розташування тіл карти. Ключі Джаймині (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) називають планети, важливі для тривалості життя та для визначення часу головних подій. Планети скрізь повертаються як індекси: 0 Сонце, 1 Місяць, 2 Марс, 3 Меркурій, 4 Юпітер, 5 Венера, 6 Сатурн, 7 Раху, 8 Кету. Знаки в ключах аспектів і Джаймині нумеруються від 0 (0 Овен — 11 Риби), а в ключах груп домів — від 1 (від 1 до 12), тож перевіряйте, з чим маєте справу. Поле запиту `planet` пишеться з великої літери й чутливе до регістру — 'Sun', а не 'sun', — а `raasi` — ціле число з нумерацією від 0 без перевірки меж, тож через значення поза 0–11 запит не виконується.
https://api.occultapi.com/api/astro/house_hora/Автентифікація
Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запиту
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| 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). |
| keys | array | обов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasiМасив рядків. Ключі, що закінчуються на '_of_the_planet', а також 'associations_of_the_planet' потребують `planet`; ключі, що закінчуються на '_of_the_raasi', а також 'baadhakas_of_raasi' потребують `raasi`. |
| latitude | number (double) | обов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -90 · max 90 |
| longitude | number (double) | обов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| node | string | обов’язковий | truemeanЗ урахуванням регістру, у нижньому регістрі. 'true' використовує істинні місячні вузли, 'mean' — середні. Будь-яке інше значення спричиняє KeyError -> 400. Передається в ядро. |
| planet | string | обов’язковий | SunMoonMarsMercuryJupiterVenusSaturnRahuKetuЗ УРАХУВАННЯМ регістру, з великої літери — зверніть увагу, що це відрізняється від назв тіл у нижньому регістрі, які використовує /api/astro/chart_analysis/. |
| raasi | integer | обов’язковий | 01234567891011Ціле число, а не рядок. Використовується як індекс знака з нумерацією ВІД 0: 0 = Овен... 11 = Риби. Перевірки меж немає, тож значення поза діапазоном спричиняють IndexError -> 400, а від’ємні мовчки відлічуються з кінця. |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
Доступні ключі (29)
Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.
| Ключ | Додаткові поля | Опис |
|---|---|---|
| argala | — | Аргала й віродхаргала для всієї карти — список із двох елементів. Перший елемент — аргала, тобто втручання, яке чинить дім: дванадцять рядків, по одному на кожен дім від асцендента; у кожному — чотири текстові значення для 2-го, 4-го, 5-го та 11-го дому від цього дому: індекси планет, що там стоять, через '/', або порожній рядок, якщо там нікого немає. Другий елемент — віродхаргала, тобто перешкода цьому втручанню, у тій самій структурі для 12-го, 10-го, 9-го та 3-го дому — саме в такому порядку, тож стовпці утворюють пари зі стовпцями аргали. |
| aspected_houses_of_the_planet | planet | Ті самі аспекти граха-дрішті, що й `aspected_rasis_of_the_planet`, але виражені номерами домів від 1 до 12 з відліком від асцендента, а не індексами знаків. Потребує `planet`. |
| aspected_houses_of_the_raasi | raasi | Доми від 1 до 12 з відліком від асцендента, які заданий знак аспектує за раші-дрішті, — усі, незалежно від того, чи є в них планета. Потребує `raasi` як індекс знака з нумерацією від 0. |
| aspected_planets_of_the_planet | planet | Планети, які задана планета аспектує за граха-дрішті — парашарським планетним аспектом, за яким кожна планета бачить 7-й дім, а Марс, Юпітер і Сатурн мають додаткові аспекти. Повертає список індексів планет. Потребує `planet`. |
| aspected_raasis_of_the_raasi | raasi | Те саме відношення раші-дрішті, що й у `aspected_houses_of_the_raasi`, але у вигляді індексів знаків із нумерацією від 0, а не номерів домів, тож від асцендента воно взагалі не залежить. Потребує `raasi`. |
| aspected_rasis_of_the_planet | planet | Знаки, які задана планета аспектує за граха-дрішті, — список індексів знаків із нумерацією від 0: від 0 для Овна до 11 для Риб. Це варіант `aspected_houses_of_the_planet` за знаками. Потребує `planet`. |
| associations_of_the_planet | planet | Усі планети, з якими задана планета суттєво пов’язана будь-яким із трьох класичних способів: вони в одному знаку, вона аспектує їх за граха-дрішті або вони обмінюються знаками (парівартана). Повертає список індексів планет без повторів. Потребує `planet`. |
| baadhakas_of_raasi | raasi | Бадхака, або дім перешкод, для заданого висхідного знака та планети, що ним управляють: 11-й для рухомих знаків, 9-й для фіксованих і 7-й для подвійних. Повертає список із двох елементів [знак бадхаки з нумерацією від 0, список індексів планет-володарів]. Потребує `raasi`. |
| brahma | — | Брахма — планета, яку Джаймині пов’язує з підтриманням життя. Це найсильніший з володарів 6-го, 8-го та 12-го домів від сильнішого з двох — асцендента чи сьомого дому. Раху й Кету не враховуються, а за рівної сили вирішують гідність, розташування в непарному знаку та положення в межах половини. Повертає один індекс планети. |
| chara_karakas | — | Вісім чара-карак у вигляді списку восьми індексів планет, упорядкованих за спаданням градуса в межах знака. Перший елемент — Атмакарака, а решта йдуть у стандартному порядку (Аматья, Бхратрі, Матрі, Пітрі, Путра, Гнаті, Дара). Кету виключено, а Раху ранжується за оберненою довготою, як вимагає класичне правило. |
| chathusras | — | Дванадцять рядків по два номери знаків 1–12. У поточній реалізації кожен рядок дає 3-й і 5-й знак від заданого — рядок 1 має вигляд [3, 5], — а не 4-й і 8-й, як у класичній парі чатусра. |
| dushthanas | — | Дванадцять рядків по три номери знаків 1–12. У поточній реалізації кожен рядок дає сам знак, 3-й і 7-й від нього — рядок 1 має вигляд [1, 3, 7], — а це не класичний набір дустхан 6-й/8-й/12-й. Тож сприймайте результат як те, що обчислює код, а не як дустхани в підручниковому розумінні. |
| kendras | — | Квадранти кожного знака: дванадцять рядків, по одному на знак, у кожному — список із чотирьох номерів знаків від 1 до 12. Рядок 0 — Овен. Не приймає аргументів. Структура відрізняється від ключа `kendras` на /api/astro/strength/, який приймає `asc_house` і повертає один плаский список із чотирьох індексів з нумерацією ВІД 0. Головне — не переплутати ці дві нумерації, що відрізняються на одиницю. |
| maheshwara | — | Те саме значення, що й `maheshwara_from_planet_positions`: цей ключ просто викликає його й повертає той самий індекс планети. Запитуйте один із них. |
| maheshwara_from_planet_positions | — | Махешвара — планета, яку Джаймині пов’язує з характером смерті. Це володар восьмого знака від Атмакараки, із класичними замінами, якщо цей володар у власному знаку або в з’єднанні чи опозиції з вузлом. Повертає один індекс планети; якщо в результаті вийшли б Раху чи Кету, їх замінюють відповідно на Меркурій чи Юпітер. |
| marakas | — | Ті самі планети-мараки, що й `marakas_from_planet_positions`, але обчислені з форми карти «дім — планета». Результат — той самий список індексів планет, тож запитуйте або один ключ, або інший, а не обидва. |
| marakas_from_planet_positions | — | Мараки, або планети, що завдають смерті: володарі 2-го та 7-го домів, а також будь-яка планета, що стоїть в одному з цих домів або разом з одним із цих володарів. Повертає список індексів планет у довільному порядку. Обчислюється за картою у формі положень планет. |
| natural_enemies_of_planets | — | Стандартна таблиця ворожнечі — список із дев’яти списків з індексами планет 0–8; у кожному — планети, ворожі до відповідної планети. Фіксована й не залежить від карти; пара до `natural_neutral_of_planets`. |
| natural_friends_of_planets | — | Постійна дружба планет, виведена з управління знаками в самій цій карті: об’єкт, де ключі — індекси планет 0–8, а значення — списки індексів дружніх їм планет. Для семи класичних планет до володарів дружніх знаків додано ще й володаря знака екзальтації. |
| natural_neutral_of_planets | — | Стандартна таблиця нейтральності — список із дев’яти списків з індексами планет 0–8; у кожному — планети, нейтральні до відповідної планети. На відміну від `natural_friends_of_planets`, це фіксована класична таблиця, яка взагалі не залежить від карти. |
| order_of_planets_by_strength | — | Усі дев’ять планет від найсильнішої до найслабшої — список із дев’яти індексів планет. Порядок визначається попарним порівнянням сили в ядрі — тим самим, яке використовується для вибору між кандидатами у володарі в розрахунках Рудри та Махешвари. |
| planets_aspecting_the_planet | planet | Ключ мав би повертати планети, що кидають граха-дрішті на задану планету, у вигляді списку індексів планет. Але зараз він порівнює назву планети з великої літери зі списками індексів, тож для будь-якого вхідного значення повертає порожній список. Натомість викличте `aspected_planets_of_the_planet` для кожної планети по черзі й оберніть результат. |
| quadrants | — | Кути кожного знака: дванадцять рядків, у кожному — чотири номери знаків 1–12: сам знак, а також 4-й, 7-й і 10-й від нього. Рядок 1 має вигляд [1, 4, 7, 10]. На цьому ендпоінті це альтернативна назва `kendras`: значення не можуть відрізнятися, тож запит обох лише займає зайве місце у відповіді. |
| raasi_drishti_of_the_planet | planet | Планети, що стоять у знаках, які власний знак заданої планети аспектує за раші-дрішті — аспектом Джаймині між знаками, за яким рухомі знаки бачать фіксовані й навпаки, а подвійні бачать одне одного. Повертає список індексів планет. Потребує `planet`. |
| rudra | — | Рудра як сильніший із двох володарів: восьмого дому від асцендента та восьмого дому від сьомого. Повертає [індекс планети, знак, у якому вона стоїть (з нумерацією від 0), три знаки тригону цього знака (з нумерацією від 0)]. Зверніть увагу: це відрізняється від `rudra_based_on_planet_positions`, який визначає другого з двох володарів інакше і тому може повернути іншу планету. |
| rudra_based_on_planet_positions | — | Рудра — планета, яку Джаймині пов’язує з руйнівним поворотом у карті; тут це сильніший із володаря восьмого знака від асцендента та володаря сьомого дому. Повертає список із трьох елементів [індекс планети, знак, у якому вона стоїть (з нумерацією від 0), три знаки тригону цього знака (з нумерацією від 0)]. Визначається інакше, ніж `rudra`, тож ці два ключі можуть назвати різні планети. |
| trikonas | — | Тригони кожного знака: дванадцять рядків, у кожному — три номери знаків 1–12: сам знак, а також 5-й і 9-й від нього. Рядок 1 має вигляд [1, 5, 9]. Чиста геометрія — однакова для кожної карти. |
| trishoola_rasis | — | Трішула-раші — тризуб із трьох знаків, за яким визначають час найбільш руйнівного періоду карти: тригони знака, у якому перебуває Рудра. Повертає три індекси знаків із нумерацією від 0. |
| upachayas | — | Дванадцять рядків по чотири номери знаків 1–12. У поточній реалізації кожен рядок дає сам знак, а також 4-й, 8-й і 9-й від нього — рядок 1 має вигляд [1, 4, 8, 9], — а не 3-й, 6-й, 10-й і 11-й, які за класикою утворюють набір упачая. |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Відповідь
{
"data": {
"trikonas": [
[
1,
5,
9
],
[
2,
6,
10
],
[
3,
7,
11
],
[
4,
8,
12
],
[
5,
9,
1
],
[
6,
10,
2
],
[
7,
11,
3
],
[
8,
12,
4
],
[
9,
1,
5
],
[
10,
2,
6
],
[
11,
3,
7
],
[
12,
4,
8
]
]
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.