Carregando o Playground
curl -X POST https://api.occultapi.com/api/astro/general_prediction/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_prediction_details"],"date_time":"2025-07-09T10:26:45.109Z","latitude":26.9124,"longitude":75.7873,"timezone":0}'Uma leitura em texto sobre caráter e vida, montada a partir de um mapa natal: o temperamento do signo lunar, o que cada um dos nove planetas significa na casa que ocupa e o que cada um dos doze senhores das casas significa na casa para onde foi. É a contraparte narrativa de /api/astro/chart_analysis/, que retorna praticamente a mesma estrutura como dados. O texto vem de fontes publicadas — a seção do signo lunar cita How to Judge a Horoscope, de B. V. Raman, em uma leitura e uma segunda fonte na outra —, então o mesmo mapa sempre gera o mesmo texto. Envie o momento do nascimento, o local e o deslocamento UTC; não há outras opções. Tudo vem como fragmentos HTML com títulos em negrito e quebras de linha, prontos para inserir em uma página. Atenção: neste endpoint, o campo do deslocamento UTC se chama `timezone`, e não `timezone_as_float`.
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| 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. Restrição de FORMATO. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC). |
| 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_prediction_detailsArray de strings; existe apenas uma chave. |
| 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 -90 · max 90 |
| 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 |
| timezone | number (double) | obrigatório | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30). Equivale a timezone_as_float, nome que outros endpoints usam para o mesmo valor. |
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_prediction_details | — | A leitura escrita completa, como um objeto de quatro strings HTML. 'Janma rasi_1' e 'Janma rasi_2' trazem duas leituras independentes das tendências mentais, físicas e gerais do signo lunar; 'Planets' percorre os nove planetas pela casa que cada um ocupa, contada a partir do ascendente; 'Houses' percorre os doze senhores das casas pela casa que ocupam. Cada valor é um único fragmento HTML com subtítulos em negrito. |