POST/api/astro/house_lord_particular_house/1 crédito

Posición del señor de una casa (un par)

El señor de una casa lleva los asuntos de esa casa allá donde va, así que los clásicos tienen un enunciado específico para cada una de las 144 combinaciones: doce señores en doce posiciones. Este endpoint devuelve el enunciado de un par. Indica en house la casa a cuyo señor te refieres, con los nombres sánscritos de bhava que usa este endpoint (lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya, de la primera a la duodécima), y en number, la casa en la que está situado, del 1 al 12. Ten en cuenta que /api/astro/effect_house_lord_different_house/ trata lo mismo con otros nombres y otro texto; no son intercambiables. No se calcula nada a partir de una carta, así que no se envía fecha, hora ni lugar: averigua antes por tu cuenta dónde está el señor. Un nombre de casa desconocido o un número fuera de rango devuelve HTTP 200 con la cadena 'Invalid key: …', no un estado de error. La única clave es get_house_lord.

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

Probar solicitud

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/json

Campos de la solicitud

Campo Tipo Obligatorio Notas

house

string

Campo	Tipo	Obligatorio	Notas
house	string	obligatorio	`lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya` El bhava cuyo SEÑOR se ubica en otra casa: lagna = 1.ª... vyaya = 12.ª. ADVERTENCIA: este endpoint usa un conjunto de nombres DISTINTO del de /api/astro/effect_house_lord_different_house/: aquí la 5.ª/6.ª/7.ª/8.ª/9.ª son 'putra', 'satru', 'yuvati', 'randhara' (fíjate en la 'a' de más: randhAra) y 'dharma'. Se pasa a minúsculas. Un valor desconocido devuelve 200 con "Invalid key: <x>".
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_lord` Array de cadenas; solo existe una clave.
number	integer	obligatorio	`123456789101112` Entero 1-12: la casa en la que está situado ese señor. Un valor fuera de rango devuelve 200 con "Invalid key: <n>".

obligatorio

lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya

El bhava cuyo SEÑOR se ubica en otra casa: lagna = 1.ª... vyaya = 12.ª. ADVERTENCIA: este endpoint usa un conjunto de nombres DISTINTO del de /api/astro/effect_house_lord_different_house/: aquí la 5.ª/6.ª/7.ª/8.ª/9.ª son 'putra', 'satru', 'yuvati', 'randhara' (fíjate en la 'a' de más: randhAra) y 'dharma'. Se pasa a minúsculas. Un valor desconocido devuelve 200 con "Invalid key: <x>".

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_lord

Array de cadenas; solo existe una clave.

number

integer

obligatorio

123456789101112

Entero 1-12: la casa en la que está situado ese señor. Un valor fuera de rango devuelve 200 con "Invalid key: <n>".

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_lord	house, number	Los resultados clásicos de que el señor de una casa ocupe otra: house indica el bhava del que es señor, y number, la casa en la que está. Devuelve una lista de enunciados breves en inglés, normalmente de uno a tres, como 'Blessed with paternal and maternal happiness'. Texto de referencia indexado por el par; no se calcula nada a partir de una carta.

Ejemplo de solicitud

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

Respuesta

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

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.