Ir para o conteúdo
POST/api/astro/house_information/1 crédito

Significações das casas

Cada casa de um mapa — os doze bhavas — governa um conjunto de assuntos da vida: a quarta, o lar e a mãe; a sétima, as parcerias; a décima, a carreira. Este endpoint retorna a ficha de referência de uma delas: o que ela representa, seu elemento e sua qualidade, os temas que rege, agrupados sob títulos, e como avaliá-la a partir do senhor da casa, dos planetas nela e dos significadores naturais. É uma consulta, não um cálculo. Você passa house_number de 1 a 12 e recebe sempre o mesmo texto — sem data, hora nem local de nascimento. Use-o para identificar as casas de um mapa já calculado em outro lugar ou para preencher um painel explicativo ao lado dele. A única chave é get_house_info. Um número fora de 1-12 retorna a string 'Invalid house number' com HTTP 200, e não um status de erro.

https://api.occultapi.com/api/astro/house_information/
Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

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

Campos da requisição

CampoTipoObrigatórioObservações
house_numberintegerobrigatório
123456789101112
keysarrayobrigatório

Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas.

get_house_info

Array de strings; existe apenas uma chave. NOTA: o arquivo de configuração se chama 'house_informations' (no plural), enquanto a rota é /api/astro/house_information/.

Chaves disponíveis (1)

Liste em keys só os cálculos que você quer. Uma chave desconhecida faz a requisição inteira ser rejeitada. O custo é 1 crédito, não importa quantas chaves você peça — então agrupe tudo numa chamada só.

ChaveCampos extras exigidosDescrição
get_house_infohouse_numberAs significações completas de um bhava, selecionado por house_number 1-12. Retorna um objeto com 'other names' (o nome em sânscrito, por exemplo Sukha Bhava), 'element & quality', uma 'description' em prosa, 'keywords & significations' — um dicionário de grupos temáticos, cada um com uma lista de frases — e 'astrological info', quatro notas sobre o senhor da casa, os planetas nela, os significadores naturais e uma regra geral para avaliá-la. Texto de referência estático, igual em todas as requisições.

Exemplo de requisição

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

Resposta

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

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data, sob cada chave que você pediu.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.