Перейти к основному содержимому
POST/api/astro/house_information/1 кредит

Значения домов

Каждый дом карты — каждая из двенадцати бхав — отвечает за свой круг жизненных вопросов: четвёртый — за дом и мать, седьмой — за партнёрство, десятый — за карьеру. Этот эндпоинт возвращает справку по одному из домов: что он означает, его стихия и качество, сферы, которыми он управляет, сгруппированные по заголовкам, и как судить о нём по управителю дома, планетам в нём и его естественным сигнификаторам. Это справочник, а не расчёт. Вы передаёте house_number от 1 до 12 и каждый раз получаете один и тот же текст — дата, время и место рождения не нужны. Используйте его, чтобы подписать карту, уже рассчитанную в другом месте, или заполнить пояснительную панель рядом с ней. Единственный ключ — get_house_info. Для номера вне 1-12 возвращается строка 'Invalid house number' с HTTP 200, а не статус ошибки.

https://api.occultapi.com/api/astro/house_information/
Попробовать запрос

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

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

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

Поля запроса

ПолеТипОбязательноПримечания
house_numberintegerобязательный
123456789101112
keysarrayобязательный

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

get_house_info

Массив строк; ключ здесь всего один. ПРИМЕЧАНИЕ: файл конфигурации называется 'house_informations' (во множественном числе), а маршрут — /api/astro/house_information/.

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

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

КлючДоп. поляОписание
get_house_infohouse_numberПолные значения одной бхавы, выбранной по house_number 1-12. Возвращает объект с 'other names' (её санскритское название, например Sukha Bhava), 'element & quality', текстовым описанием 'description', 'keywords & significations' — словарём тематических групп, каждая из которых — список фраз, — и 'astrological info' — четырьмя заметками об управителе дома, находящихся в нём планетах, естественных сигнификаторах и общем правиле суждения о нём. Статический справочный текст, одинаковый для каждого запроса.

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

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

Ответ

{
  "data": {
    "get_house_info": {
      "other names": "Sukha Bhava",
      "element & quality": "Movable, Water",
      "description": "The 4th house represents comfort, emotional happiness, and inner peace. It is deeply tied to one's home, mother, vehicles, land, and personal well-being. It is also connected to learning, cultural roots, and sacred knowledge. As the house of shelter, nurturing, and support, it governs the environments that provide safety and emotional grounding.",
      "keywords & significations": {
        "Comfort & Happiness": [
          "emotional peace",
          "joy",
          "contentment",
          "domestic bliss",
          "the source of one's sense of well-being"
        ],
        "Mother & Maternal Side": [
          "mother",
          "maternal relatives",
          "relationship with maternal lineage"
        ],
        "Home & Property": [
          "house",
          "real estate",
          "property matters",
          "living space",
          "entering a new home",
          "ancestral property",
          "loss of residence"
        ],
        "Conveyance & Travel": [
          "vehicles (rickshaws, boats, etc.)",
          "means of transportation",
          "local travel"
        ],
        "Land & Agriculture": [
          "land",
          "agriculture",
          "fertile fields",
          "gardens",
          "ponds and wells (including construction)",
          "land arising from islands or wet zones",
          "grain from wetlands"
        ],
        "Learning & Intellect": [
          "learning",
          "sacred texts",
          "wise counsel",
          "pure intellect"
        ],
        "Physical Comforts": [
          "perfumes",
          "clothing",
          "ornaments",
          "oil baths",
          "water and drinks",
          "celestial foods"
        ],
        "Cultural & Spiritual Values": [
          "castes",
          "rites",
          "religion-based education",
          "victory in personal efforts",
          "divine remedies"
        ],
        "Family & Relations": [
          "relatives",
          "well-wishers",
          "father",
          "wife",
          "friends",
          "children of siblings"
        ],
        "Security & Wealth": [
          "securing of savings",
          "stable financial base",
          "result or conclusion of efforts"
        ],
        "Animals & Livelihood": [
          "cattle (cows, buffaloes)",
          "horses",
          "elephants",
          "domestic animals for livelihood"
        ],
        "Creative & Domestic Arts": [
          "architecture",
          "art",
          "house-building skills",
          "pavilions",
          "layout and use of spaces"
        ],
        "Challenges": [
          "false accusations",
          "loss of home",
          "tiring or exhausting work"
        ],
        "Unique Aspects": [
          "trust",
          "noble reputation",
          "guidance in locating lost or hidden items",
          "anthills"
        ]
      },
      "astrological info": {
        "4th Lord (4L)": "Plays a pivotal role in determining sources of emotional comfort and security. Its placement, dignity, and the Bhava it occupies are key",
        "Planets in 4H": "Influence the nature of one's peace and comforts. When placed in their own, exalted, or friendly signs, they enhance well-being. If debilitated or afflicted by challenging combinations, the associated areas may become sources of discomfort",
        "Karaka Planets": "Moon – for mother and emotional nourishment; Venus – for conveyances, comforts, and pleasures; Mars – for land and property",
        "General Rule": "Strong, benefic influences on the 4th house and its lord lead to happiness, prosperity at home, and mental tranquility. Affliction or weakness indicates emotional disturbances or issues related to home and domestic life"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

Ошибки

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