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

Varredura de mês lunar

Encontra os instantes exatos de início e fim de um mês lunar hindu específico — Chaitra, Vaisakha, Jyeshtha e assim por diante — dentro de um ano civil. Útil para agendar tudo o que segue o mês lunar, e não o gregoriano. reckoning define onde ficam os limites. Em 'amanta' (o padrão, usado no sul e no oeste), um mês vai de uma lua nova à seguinte e recebe o nome do signo da Lua na lua nova que o abre. Em 'poornima', vai de uma lua cheia à seguinte e recebe o nome do signo do Sol na lua cheia que o abre; é a contagem dos calendários do norte e, na quinzena escura, as duas contagens colocam o mesmo dia em meses com nomes diferentes. Passe month_name, year e timezone_as_float; não é preciso informar o local. A resposta é {year, month_name, reckoning, rows}, em que rows é uma lista de timestamps UTC {start, end} — em geral uma entrada, e duas quando um mês adhika (intercalar) de mesmo nome também cai naquele ano. A varredura não indica qual dos dois é o mês intercalar.

https://api.occultapi.com/api/astro/lunar_month_scan/
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
month_namestringobrigatório
VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra
timezone_as_floatnumber (double)obrigatório

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.

yearintegerobrigatório

Ano de nascimento como número, por exemplo 1990. Quatro dígitos.

min 1800 · max 2400

reckoningstringopcional
amantapoornima

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/lunar_month_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month_name":"Vaisakha","timezone_as_float":5.5,"year":2026,"reckoning":"amanta"}'

Resposta

{
  "data": {
    "year": 2026,
    "month_name": "Vaisakha",
    "reckoning": "amanta",
    "rows": [
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-05-16T20:01:32+00:00"
      }
    ]
  },
  "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.