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

Тлумачення розміщень планет

Тіло запитуJSON

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

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

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

Заздалегідь написані тлумачення для однієї планети в одному положенні. Вкажіть планету й де вона стоїть — знак зодіаку, дім чи накшатру, — і ендпоінт поверне класичне тлумачення цього поєднання. Це пошук у корпусі текстів, а не розрахунок: дата, час і місце тут не потрібні, а той самий запит завжди повертає той самий текст. Використовуйте його для підписів до вже обчисленої карти. Візьміть знак, дім і накшатру Юпітера з `/api/astro/chart/`, а потім викличте цей ендпоінт, щоб отримати текст. Усі три ключі можна запитати одним викликом, але кожен має власний додатковий параметр, тож якщо запитуєте всі три, у тілі запиту мають бути `planet`, `sign`, `house` і `nakshatra`. Охоплено дев’ять планет (сім плюс Раху й Кету) у дванадцяти знаках і дванадцяти домах. Тлумачення за накшатрами є лише для семи класичних планет — для Раху й Кету їх немає. Нерозпізнана планета, знак, дім чи накшатра повертаються як пояснювальний рядок з HTTP 200, а не як помилка, тож перед відображенням перевіряйте тип отриманого значення.

Поля запиту

Поле	Тип	Обов’язкове	Примітки
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`.

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