Загружаем песочницу
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'. |
Перечислите в 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`. |