/api/astro/prashna/1 créditoPontos sensíveis do Prashna
Prashna é astrologia horária: um mapa levantado para o momento em que uma pergunta é feita, e não para um nascimento. Este endpoint calcula os pontos sensíveis em que o Prashna e a análise de longevidade se apoiam — combinações aritméticas de longitudes que não são planetas, mas são lidas como se fossem. Gulika, também chamado Mandi, o ponto sombrio associado a Saturno, é a base da maioria deles. Envie `date_time` em ISO 8601, `latitude`, `longitude`, um rótulo `name` para o mapa, `node_type` (nodo lunar `true` ou `mean`) e `add_yogi_longitude`. Tudo vem de uma vez; não há chaves a selecionar. Exceto `gulika_longitude`, que é um número simples de graus, cada ponto vem como `{longitude, astrological: {degree, sign, minutes, seconds}, constellation, nakshatra, pada}` — uma longitude sideral com sua posição em um signo, um índice de nakshatra baseado em zero, e o nome e o quarto do nakshatra. O que é cada um: `trisphuta` é ascendente mais Lua mais Gulika; `chatursphuta` soma o Sol a isso; `panchasphuta` soma o nodo lunar. `pranasphuta` (cinco vezes o ascendente, mais Gulika), `dehasphuta` (oito vezes a Lua, mais Gulika) e `mrityusphuta` (sete vezes Gulika, mais o Sol) são os pontos da vida, do corpo e da morte, e `sookshmatrisphuta` é a soma deles. `beejasphuta` (Sol mais Júpiter mais Vênus) e `kshetrasphuta` (Lua mais Júpiter mais Marte) são os pontos de fertilidade masculino e feminino. `tithisphuta` é Lua menos Sol, e `rahutithisphuta` é o mesmo com o nodo no lugar da Lua. `yogisphuta` é Sol mais Lua mais 93°20', `avayogisphuta` é isso mais outros 186°40', e `santanatithi` é cinco doze avos do arco Lua menos Sol. Três pontos de atenção. `yogasphuta` é o mesmo cálculo que `yogisphuta`, exceto que os 93°20' só são somados quando `add_yogi_longitude` é true; assim, com essa flag ativada, os dois campos são idênticos. `santanatithi` não é reduzido ao intervalo 0–360 e, por isso, pode vir negativo. E o Gulika é calculado com um deslocamento fixo de +05:30, seja qual for a localização informada, o que desloca todos os pontos derivados de Gulika para locais bem fora desse fuso.
https://api.occultapi.com/api/astro/prashna/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 |
|---|---|---|---|
| add_yogi_longitude | boolean | obrigatório | |
| date_time | string (date-time) | obrigatório | O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes. |
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -180 · max 180 |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180 |
| name | string | obrigatório | |
| node_type | string | obrigatório | truemeanEm minúsculas, correspondência exata. Seleciona entre o nodo lunar verdadeiro e o médio para os cálculos de sphuta. |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/prashna/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2024-11-14T11:59:23.365Z","longitude":74.319,"latitude":26.1046,"name":"RashiChart","node_type":"true","add_yogi_longitude":true}'Resposta
{
"data": {
"gulika_longitude": 243.2836111111111,
"trisphuta": {
"longitude": 277.6645540646069,
"astrological": {
"degree": 7,
"sign": "Cp",
"minutes": 39,
"seconds": 52
},
"constellation": 9,
"nakshatra": "Uttaraashaadha",
"pada": 4
},
"chatursphuta": {
"longitude": 126.06855406460689,
"astrological": {
"degree": 6,
"sign": "Le",
"minutes": 4,
"seconds": 6
},
"constellation": 4,
"nakshatra": "Makha",
"pada": 2
},
"panchasphuta": {
"longitude": 107.64255406460688,
"astrological": {
"degree": 17,
"sign": "Cn",
"minutes": 38,
"seconds": 33
},
"constellation": 3,
"nakshatra": "Aasresha",
"pada": 1
},
"pranasphuta": {
"longitude": 10.578325878590022,
"astrological": {
"degree": 10,
"sign": "Ar",
"minutes": 34,
"seconds": 41
},
"constellation": 0,
"nakshatra": "Ashwini",
"pada": 4
},
"dehasphuta": {
"longitude": 314.6596111111111,
"astrological": {
"degree": 14,
"sign": "Aq",
"minutes": 39,
"seconds": 34
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 3
},
"mrityusphuta": {
"longitude": 111.3892777777778,
"astrological": {
"degree": 21,
"sign": "Cn",
"minutes": 23,
"seconds": 21
},
"constellation": 3,
"nakshatra": "Aasresha",
"pada": 2
},
"sookshmatrisphuta": {
"longitude": 76.6272147674789,
"astrological": {
"degree": 16,
"sign": "Ge",
"minutes": 37,
"seconds": 37
},
"constellation": 2,
"nakshatra": "Aardra",
"pada": 3
},
"beejasphuta": {
"longitude": 152.48299999999995,
"astrological": {
"degree": 2,
"sign": "Vi",
"minutes": 28,
"seconds": 58
},
"constellation": 5,
"nakshatra": "Uttara Phalguni",
"pada": 2
},
"kshetrasphuta": {
"longitude": 162.847,
"astrological": {
"degree": 12,
"sign": "Vi",
"minutes": 50,
"seconds": 49
},
"constellation": 5,
"nakshatra": "Hasta",
"pada": 1
},
"tithisphuta": {
"longitude": 160.518,
"astrological": {
"degree": 10,
"sign": "Vi",
"minutes": 31,
"seconds": 4
},
"constellation": 5,
"nakshatra": "Hasta",
"pada": 1
},
"yogasphuta": {
"longitude": 310.65933333333334,
"astrological": {
"degree": 10,
"sign": "Aq",
"minutes": 39,
"seconds": 33
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 2
},
"yogisphuta": {
"longitude": 310.65933333333334,
"astrological": {
"degree": 10,
"sign": "Aq",
"minutes": 39,
"seconds": 33
},
"constellation": 10,
"nakshatra": "Satabhishak",
"pada": 2
},
"avayogisphuta": {
"longitude": 137.32600000000002,
"astrological": {
"degree": 17,
"sign": "Le",
"minutes": 19,
"seconds": 33
},
"constellation": 4,
"nakshatra": "Poorva Phalguni",
"pada": 2
},
"rahutithisphuta": {
"longitude": 133.17000000000002,
"astrological": {
"degree": 13,
"sign": "Le",
"minutes": 10,
"seconds": 12
},
"constellation": 4,
"nakshatra": "Makha",
"pada": 4
},
"santanatithi": {
"longitude": -83.11749999999999,
"astrological": {
"degree": 6,
"sign": "Cp",
"minutes": 52,
"seconds": 56
},
"constellation": 9,
"nakshatra": "Uttaraashaadha",
"pada": 4
}
},
"message": "successful",
"is_error": false
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.
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.