Ir para o conteúdo
POST/api/astro/shani_analysis/1 crédito

Fases do trânsito de Saturno

O lento percurso de Saturno pelo zodíaco produz quatro fases com nome próprio que a astrologia indiana acompanha de perto, todas medidas a partir da Lua natal ou do ascendente natal: Sade Sati, os sete anos e meio em torno da passagem de Saturno sobre esse ponto; Ashtama Shani, Saturno na oitava casa a partir dele; Kantaka Shani, Saturno na quarta, na sétima ou na décima; e Dhaiya, também chamado Ardhashtama, Saturno na quarta ou na oitava. Este endpoint informa se cada fase está em curso em um dado momento, quando termina e quando começa a próxima. Envie dois mapas: os dados de nascimento em `date_time_natal`, `latitude_natal`, `longitude_natal` e `chart_name_natal`, e o momento que você quer consultar nos campos `_transit` correspondentes. `ref_celestial` define se as fases são medidas a partir da Lua natal ou do ascendente natal. `mode` define o rigor do teste — 0 verifica a posição por casas de signo inteiro, e os valores mais altos verificam uma janela em graus em torno do ponto de referência, o que dá datas de início e fim bem mais justas. A resposta contém oito objetos. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` e `sade_sati_shani` são, cada um, `{status, end_date}`: um booleano que indica se a fase está em curso no momento do trânsito e, se estiver, a data de término em ISO 8601 e UTC; caso contrário, null. `next_ashtama_shani`, `next_kantaka_shani` e `next_dhaiya_shani` são `{date, ref_house_from_natal}`, com a data de início da próxima ocorrência e a casa, contada a partir do ponto de referência, que a desencadeia; `next_sade_sati_shani` traz apenas `{date}`. A busca para a frente cobre cem anos a partir do momento do trânsito. Como Kantaka e Dhaiya incluem a quarta casa, os dois costumam informar as mesmas datas. Isso é esperado, não é duplicação.

https://api.occultapi.com/api/astro/shani_analysis/
Testar requisição

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

Campos da requisição

CampoTipoObrigatórioObservações
chart_name_natalstringobrigatório
chart_name_transitstringobrigatório
date_time_natalstring (date-time)obrigatório
date_time_transitstring (date-time)obrigatório
latitude_natalnumber (double)obrigatório

min -180 · max 180

latitude_transitnumber (double)obrigatório

min -180 · max 180

longitude_natalnumber (double)obrigatório

min -180 · max 180

longitude_transitnumber (double)obrigatório

min -180 · max 180

modeintegerobrigatório
ref_celestialstringobrigatório
ascendantmoon

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/shani_analysis/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time_natal":"2025-11-21T05:41:58.124Z","date_time_transit":"2024-11-21T05:41:58.124Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"ascendant","mode":0}'

Resposta

{
  "data": {
    "ashtama_shani": {
      "status": false,
      "end_date": null
    },
    "kantaka_shani": {
      "status": false,
      "end_date": null
    },
    "dhaiya_shani": {
      "status": false,
      "end_date": null
    },
    "sade_sati_shani": {
      "status": true,
      "end_date": "2025-03-09T10:21:25Z"
    },
    "next_ashtama_shani": {
      "date": "2036-08-08T03:38:39Z",
      "ref_house_from_natal": 8
    },
    "next_kantaka_shani": {
      "date": "2027-05-11T00:01:56Z",
      "ref_house_from_natal": 4
    },
    "next_dhaiya_shani": {
      "date": "2027-05-11T00:01:56Z",
      "ref_house_from_natal": 4
    },
    "next_sade_sati_shani": {
      "date": "2046-02-22T02:59:10Z"
    }
  },
  "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.