POST/api/astro/house_lord_particular_house/1 кредит

Положение управителя дома (одна пара)

Управитель дома несёт дела этого дома туда, куда попадает, поэтому в классических текстах есть отдельное утверждение для каждого из 144 сочетаний — двенадцать управителей в двенадцати местах. Этот эндпоинт возвращает утверждение для одной пары. В house укажите дом, чей управитель вас интересует, используя принятые на этом эндпоинте санскритские названия бхав — lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya для домов с первого по двенадцатый, — а в number — дом, в котором он находится, от 1 до 12. Обратите внимание: /api/astro/effect_house_lord_different_house/ охватывает ту же тему, но с другим набором названий и другим текстом; эти эндпоинты не взаимозаменяемы. По карте ничего не рассчитывается, поэтому дата, время и место не передаются — сначала сами определите положение управителя. Для неизвестного названия дома или номера вне диапазона возвращается HTTP 200 со строкой 'Invalid key: …', а не статус ошибки. Единственный ключ — get_house_lord.

https://api.occultapi.com/api/astro/house_lord_particular_house/

Попробовать запрос

Аутентификация

Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запроса

Поле Тип Обязательно Примечания

house

string

Поле	Тип	Обязательно	Примечания
house	string	обязательный	`lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya` Бхава, УПРАВИТЕЛЬ которой размещается: lagna = 1-й... vyaya = 12-й. ПРЕДУПРЕЖДЕНИЕ: этот эндпоинт использует ДРУГОЙ набор названий, чем /api/astro/effect_house_lord_different_house/: здесь 5-й/6-й/7-й/8-й/9-й — это 'putra', 'satru', 'yuvati', 'randhara' (обратите внимание на лишнюю 'a': randhAra) и 'dharma'. Приводится к нижнему регистру. Для неизвестного значения возвращается 200 с "Invalid key: <x>".
keys	array	обязательный	Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. `get_house_lord` Массив строк; ключ здесь всего один.
number	integer	обязательный	`123456789101112` Целое число 1-12 — дом, в котором находится этот управитель. Для значения вне диапазона возвращается 200 с "Invalid key: <n>".

обязательный

lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya

Бхава, УПРАВИТЕЛЬ которой размещается: lagna = 1-й... vyaya = 12-й. ПРЕДУПРЕЖДЕНИЕ: этот эндпоинт использует ДРУГОЙ набор названий, чем /api/astro/effect_house_lord_different_house/: здесь 5-й/6-й/7-й/8-й/9-й — это 'putra', 'satru', 'yuvati', 'randhara' (обратите внимание на лишнюю 'a': randhAra) и 'dharma'. Приводится к нижнему регистру. Для неизвестного значения возвращается 200 с "Invalid key: <x>".

keys

array

обязательный

Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами.

get_house_lord

Массив строк; ключ здесь всего один.

number

integer

обязательный

123456789101112

Целое число 1-12 — дом, в котором находится этот управитель. Для значения вне диапазона возвращается 200 с "Invalid key: <n>".

Доступные ключи (1)

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

Ключ	Доп. поля	Описание
get_house_lord	house, number	Классические результаты нахождения управителя одного дома в другом: house — бхава, управителем которой он является, number — дом, в котором он находится. Возвращает список коротких утверждений на английском языке, обычно от одного до трёх, например 'Blessed with paternal and maternal happiness'. Справочный текст по паре значений; из карты ничего не выводится.

Пример запроса

curl -X POST https://api.occultapi.com/api/astro/house_lord_particular_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_house_lord"],"house":"lagna","number":4}'

Ответ

{
  "data": {
    "get_house_lord": [
      "Blessed with paternal and maternal happiness",
      "Gains many brothers, is charming, virtuous, and has a passionate nature"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.

Ошибки

Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.