/api/astro/planet_insights/1 кредитТолкования положений планет
Готовые толкования для одной планеты в одном положении. Передайте планету и то, где она стоит, — знак зодиака, дом или накшатру, — и эндпоинт вернёт классическое толкование этого сочетания. Это поиск по корпусу текстов, а не расчёт: дата, время и место не нужны, и на один и тот же запрос всегда возвращается один и тот же текст. Используйте его для подписей к уже рассчитанной карте: возьмите знак, дом и накшатру Юпитера из `/api/astro/chart/`, а текст получите здесь. Все три ключа можно запросить за один вызов, но у каждого свой дополнительный параметр, поэтому при запросе всех трёх в теле запроса должны быть `planet`, `sign`, `house` и `nakshatra`. Охват — девять планет (семь классических плюс Раху и Кету) по двенадцати знакам и двенадцати домам. Толкования по накшатрам есть только для семи классических планет, для Раху и Кету их нет. Если планета, знак, дом или накшатра не распознаны, возвращается поясняющая строка с HTTP 200, а не ошибка, поэтому перед выводом проверяйте, какой тип вы получили.
https://api.occultapi.com/api/astro/planet_insights/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| house | integer | обязательный | |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. |
| nakshatra | string | обязательный | ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguniПриведённый выше список используется для jupiter, mercury, venus и saturn. Для 'rahu' и 'ketu' данных по накшатрам нет вовсе. Для ненайденных значений возвращается "Invalid nakshatra: <x> for planet <p>" с HTTP 200. |
| planet | string | обязательный | sunmoonmarsmercuryjupitervenussaturnrahuketuДля неизвестной планеты возвращается строка "Invalid planet: <x>" с HTTP 200, а не статус ошибки. Обратите внимание: у rahu и ketu НЕТ данных по накшатрам (insights['rahu']['nakshatras'] is None), поэтому get_planet_nakshatra_insight возвращает "No nakshatra data available for rahu". |
| sign | string | обязательный | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesОШИБКА В ДАННЫХ, которую стоит задокументировать: для planet='sun' ключ написан с опечаткой — 'vigro' вместо 'virgo', поэтому sun+virgo возвращает "Invalid sign: virgo for planet sun", а sun+vigro работает. У остальных восьми планет — 'virgo'. |
Доступные ключи (3)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| get_planet_house_insight | planet, house | Толкование для `planet` в доме `house` (от 1 до 12). Возвращает объект с подписью дома, кратким описанием и списками черт, а также `classicalTexts` — список `{heading, text}` с цитатами из Парашары, «Брихат Джатаки», «Саравали» и «Пхаладипики» об этом положении — и `houseLordVariations`, список `{ascendent, aspect, result}`, который показывает, как меняется толкование для каждого из двенадцати асцендентов. Там, где есть только классические цитаты, часть полей краткого описания и черт равна null. |
| get_planet_nakshatra_insight | planet, nakshatra | Толкование для `planet` в `nakshatra` — одно-два предложения простого текста, а не структурированный объект. Есть для семи классических планет по всем 27 накшатрам; для Раху и Кету толкований по накшатрам нет, и вместо них возвращается поясняющая строка. |
| get_planet_sign_insight | planet, sign | Толкование для `planet` в `sign`. Возвращает объект с `sign` (санскритная подпись для сочетания, например "Mesa Brhaspati"), абзацем `summary` и списками `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` и `drstiphala`; последний описывает действие аспектов планеты из этого положения. Обратите внимание на пробел в названии поля `core traits`. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'Ответ
{
"data": {
"get_planet_sign_insight": {
"sign": "Mesa Brhaspati",
"summary": "Jupiter in Aries produces a bold, authoritative, and resourceful individual with strong leadership capabilities. Aries is ruled by Mars (Maṅgala), a planet friendly to Jupiter and symbolizing courage, initiative, and battle-readiness. Jupiter here gains the spirit of a warrior-sage, combining spiritual strength with physical initiative. The placement enhances fame, wealth, power, and generational prosperity, especially through sons. However, the position also introduces difficulties like enemies, physical injuries, and excessive expenditures due to Aries being the debilitation sign for Saturn (Śani), whose tamasic qualities interfere with Jupiter's sattvic nature. The individual is splendorous, generous, and powerful, but also faces trials that temper their greatness",
"core traits": [
"Argumentative in disposition",
"Acquiring precious stones and ornaments through effort",
"Endowed with strength, sons, and wealth",
"Eminent and famous profession",
"Splendorous",
"Many enemies",
"Many expenses",
"Injured body",
"Confers severe and cruel punishments"
],
"psychologicalPhysicalTraits": [
"Argumentative in disposition",
"Acquiring precious stones and ornaments through effort",
"Endowed with strength, sons, and wealth",
"Eminent and famous profession",
"Splendorous",
"Many enemies",
"Many expenses",
"Injured body",
"Confers severe and cruel punishments",
"Love of grandeur",
"Powerful",
"Wealthy",
"Prudent",
"Many children",
"Courteous",
"Generous",
"Firm",
"Sympathetic",
"Happy marriage",
"Patient nature",
"Harmonious",
"Refined",
"High position"
],
"astrologicalReasoning": [
{
"heading": "Initiative & Argumentation",
"text": "Meṣa is ruled by Maṅgala, the god of war and action, endowing Jupiter with a strong fighting disposition and argumentative temperament."
},
{
"heading": "Wealth & Luxuries",
"text": "Sūrya, exalted in Meṣa, governs precious metals and gemstones. Jupiter, the Dhanakāraka, placed here results in acquiring valuables through effort."
},
{
"heading": "Progeny & Strength",
"text": "Meṣa is a masculine sign ruled by male planets (Sūrya and Maṅgala). Jupiter, as the Santana Kāraka, gains support here, indicating sons, strength, and vitality."
},
{
"heading": "Fame & Eminence",
"text": "As the 1st house of Kālapuruṣa, Aries governs fame. Jupiter's placement brings name, professional eminence, and public recognition."
},
{
"heading": "Drawbacks of the Sign",
"text": "Meṣa is Śani's debilitation sign. Jupiter here absorbs Śani's weaknesses, causing a rise in enemies (6H), injury-proneness, emotional detachment (due to 8H being Moon's debilitation), and heavy expenditure (12H effects)."
},
{
"heading": "Judgement & Harshness",
"text": "With Jupiter reflecting Maṅgala's and Śani's stern traits, the native may confer harsh or severe judgments lacking emotional nuance."
}
],
"drstiphala": [
{
"planet": "Sūrya",
"aspect": "positive",
"result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
},
{
"planet": "Candra",
"aspect": "positive",
"result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
},
{
"planet": "Maṅgala",
"aspect": "positive",
"result": "Belonging to a royal dynasty, fearless, fierce, endowed with political knowledge, modest, affluent, has a disobedient wife and disobedient servants."
},
{
"planet": "Budha",
"aspect": "negative",
"result": "Liar, crafty, sinful, skilful in detecting others' flaws, serves others, grateful, modest, not outspoken."
},
{
"planet": "Śukra",
"aspect": "positive",
"result": "Very happy with residences, sleeping comforts, robes, perfumes, garlands, ornaments, wife, very timid."
},
{
"planet": "Śani",
"aspect": "mixed",
"result": "Talkative, eloquent, devoid of happiness, brilliant, has mean children and a mean wife."
}
]
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.