/api/astro/house_information/1 créditoSignificaciones de las casas
Cada casa de una carta (los doce bhavas) rige un conjunto de asuntos de la vida: la cuarta, el hogar y la madre; la séptima, la pareja; la décima, la carrera profesional. Este endpoint devuelve la ficha de referencia de una de ellas: qué representa, su elemento y su cualidad, los temas que rige agrupados por epígrafes y cómo juzgarla a partir del señor de la casa, los planetas que contiene y sus significadores naturales. Es una consulta, no un cálculo. Pasas house_number del 1 al 12 y recibes siempre el mismo texto: no intervienen fecha, hora ni lugar de nacimiento. Úsalo para rotular una carta que ya hayas calculado en otro sitio o para rellenar un panel explicativo junto a ella. La única clave es get_house_info. Un número fuera de 1-12 devuelve la cadena 'Invalid house number' con HTTP 200, no un estado de error.
https://api.occultapi.com/api/astro/house_information/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| house_number | integer | obligatorio | 123456789101112 |
| keys | array | obligatorio | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. get_house_infoArray de cadenas; solo existe una clave. NOTA: el archivo de configuración se llama 'house_informations' (en plural), mientras que la ruta es /api/astro/house_information/. |
Claves disponibles (1)
Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.
| Clave | Campos adicionales | Descripción |
|---|---|---|
| get_house_info | house_number | Las significaciones completas de un bhava, elegido con house_number 1-12. Devuelve un objeto con 'other names' (su nombre sánscrito, p. ej., Sukha Bhava), 'element & quality', una 'description' en prosa, 'keywords & significations' (un diccionario de grupos temáticos, cada uno con una lista de frases) y 'astrological info', cuatro notas sobre el señor de la casa, los planetas situados en ella, los significadores naturales y una regla general para juzgarla. Texto de referencia estático, idéntico en todas las solicitudes. |
Ejemplo de solicitud
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}'Respuesta
{
"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"
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data, cada uno bajo la clave que pediste.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.