/api/astro/house_lord_particular_house/1 créditoPosição do senhor da casa (um par)
O senhor de uma casa leva os assuntos dessa casa aonde quer que vá; por isso, os clássicos têm um enunciado específico para cada uma das 144 combinações — doze senhores em doze lugares. Este endpoint retorna o enunciado de um par. Indique no campo house a casa cujo senhor você quer, usando os nomes sânscritos de bhava deste endpoint — lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya, da primeira à décima segunda — e informe em number a casa em que ele está, de 1 a 12. Atenção: /api/astro/effect_house_lord_different_house/ trata do mesmo assunto com outro conjunto de nomes e outro texto; os dois não são intercambiáveis. Nada é calculado a partir de um mapa, então não se envia data, hora nem local — descubra antes, por conta própria, onde o senhor está posicionado. Um nome de casa desconhecido ou um número fora do intervalo retorna HTTP 200 com a string 'Invalid key: …', e não um status de erro. A única chave é get_house_lord.
https://api.occultapi.com/api/astro/house_lord_particular_house/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/jsonCampos da requisição
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| house | string | obrigatório | lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyayaO bhava cujo SENHOR está sendo posicionado: lagna = 1ª... vyaya = 12ª. ATENÇÃO: este endpoint usa um conjunto de nomes DIFERENTE do de /api/astro/effect_house_lord_different_house/ - aqui as casas 5ª/6ª/7ª/8ª/9ª são 'putra', 'satru', 'yuvati', 'randhara' (observe o 'a' extra: randhAra) e 'dharma'. Convertido para minúsculas por. Um valor desconhecido retorna 200 com "Invalid key: <x>". |
| keys | array | obrigató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_lordArray de strings; existe apenas uma chave. |
| number | integer | obrigatório | 123456789101112Inteiro 1-12 - a casa em que esse senhor está posicionado. Um valor fora do intervalo retorna 200 com "Invalid key: <n>". |
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ó.
| Chave | Campos extras exigidos | Descrição |
|---|---|---|
| get_house_lord | house, number | Os resultados clássicos quando o senhor de uma casa ocupa outra: o campo house indica o bhava do qual ele é senhor, e o campo number, a casa em que ele está. Retorna uma lista de enunciados curtos em inglês, geralmente de um a três, como 'Blessed with paternal and maternal happiness'. Texto de referência indexado pelo par, sem nada derivado de um mapa. |
Exemplo de requisição
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}'Resposta
{
"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"
}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.