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

Períodos de combustão

Quando um planeta está perto demais do Sol para ser visto, diz-se que ele está combusto — asta, 'ocaso' —, e os textos clássicos o tratam como queimado e incapaz de produzir seus resultados. Este endpoint retorna, para um planeta, todos os períodos de combustão que caem, ao menos em parte, em um ano civil. O teste é puramente angular. O planeta fica combusto enquanto sua elongação geocêntrica em relação ao Sol estiver abaixo de um orbe próprio de cada planeta: 17° para Marte, 14° para Mercúrio direto e 12° retrógrado, 10° para Vênus direto e 8° retrógrado, 11° para Júpiter e 15° para Saturno. O ano é varrido com uma margem em cada ponta, porque um período pode atravessar a virada do ano, e cada cruzamento é depois refinado por bisseção. Envie `planet` (mars, mercury, venus, jupiter ou saturn) e `year`. A resposta é `{planet, year, periods, total_asta_days_in_year}`, em que cada período traz `start`, `end`, `duration_days` para o período inteiro e `days_in_year` para a parte que cai dentro do ano solicitado. A elongação não depende de onde você está, então os horários não dependem da localização; `timezone_as_float` só define como eles são exibidos.

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

Testar requisição

Dados de Períodos de combustão exibidos numa interface — Os dados deste endpoint exibidos numa interface real. A API entrega os valores; o layout é você quem monta.

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

Campo	Tipo	Obrigatório	Observações
planet	string	obrigatório	`marsmercuryvenusjupitersaturn`
year	integer	obrigatório	Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400
latitude	number (double)	opcional	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.
longitude	number (double)	opcional	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.
timezone_as_float	number (double)	opcional	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/combustion/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"planet":"mars","year":2026,"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Resposta

{
  "data": {
    "planet": "mars",
    "year": 2026,
    "periods": [
      {
        "start": "2025-11-06T23:51:13.853078",
        "end": "2026-03-26T14:07:06.209182",
        "duration_days": 139.6,
        "days_in_year": 84.6
      }
    ],
    "total_asta_days_in_year": 84.6
  },
  "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.