Перейти до вмісту
POST/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

Поля запиту

ПолеТипОбов’язковеПримітки
houseintegerобов’язковий
keysarrayобов’язковий

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

nakshatrastringобов’язковий
ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguni

Наведений вище список використовують jupiter, mercury, venus і saturn. Для 'rahu' і 'ketu' даних про накшатри немає взагалі. Значення без збігу повертають "Invalid nakshatra: <x> for planet <p>" з HTTP 200.

planetstringобов’язковий
sunmoonmarsmercuryjupitervenussaturnrahuketu

Невідома планета повертає рядок "Invalid planet: <x>" з HTTP 200, а не статус помилки. Зверніть увагу: для rahu і ketu НЕМАЄ даних про накшатри (insights['rahu']['nakshatras'] is None), тож get_planet_nakshatra_insight повертає "No nakshatra data available for rahu".

signstringобов’язковий
ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces

БАГ У ДАНИХ, який варто задокументувати: для planet='sun' ключ написано з одруком 'vigro' замість 'virgo', тож sun+virgo повертає "Invalid sign: virgo for planet sun", а sun+vigro працює. Усі вісім інших планет використовують 'virgo'.

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

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

КлючДодаткові поляОпис
get_planet_house_insightplanet, houseТлумачення для `planet` у домі, де `house` — від 1 до 12. Повертає об’єкт із підписом дому, підсумком і списками рис, а також `classicalTexts` — список `{heading, text}` із цитатами з Парашари, «Бріхат Джатаки», «Саравалі» та «Пхаладіпіки» про це розміщення — і `houseLordVariations`, список `{ascendent, aspect, result}`, що показує, як тлумачення змінюється для кожного з дванадцяти асцендентів. Деякі поля підсумку й рис дорівнюють null там, де є лише класичні цитати.
get_planet_nakshatra_insightplanet, nakshatraТлумачення для `planet` у `nakshatra` у вигляді одного-двох речень простого тексту, а не структурованого об’єкта. Доступне для семи класичних планет у всіх 27 накшатрах; для Раху й Кету тлумачень за накшатрами немає, і натомість повертається пояснювальний рядок.
get_planet_sign_insightplanet, 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. Детальніше — у довіднику помилок.