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

Varredura anual de tithi

Um tithi é um trigésimo do mês lunar — o intervalo de tempo durante o qual a Lua ganha mais 12 graus de elongação em relação ao Sol. Os tithis são a unidade com que se define quase toda observância hindu, e não coincidem com os dias civis: um tithi pode durar apenas cerca de dezenove horas ou chegar a cerca de vinte e seis, então uma única ocorrência muitas vezes abrange duas datas. Este endpoint recebe um tithi específico e retorna todas as ocorrências dele em um ano civil, com o instante real em que cada uma começa e termina. `tithi_number` vai de 1 a 30: 1-15 vão de Shukla Pratipada a Purnima, 16-29 vão de Krishna Pratipada a Chaturdashi, e 30 é Amavasya. `year` é o ano civil local, e `timezone_as_float` decide que ano local é esse (5.5 para IST). Não são necessárias coordenadas, porque um tithi começa e termina no mesmo instante em todos os lugares da Terra. A resposta é `{year, tithi_number, rows}`, sendo `rows` uma lista cronológica de timestamps ISO `{start, end}` em UTC — normalmente doze ou treze entradas, já que um determinado tithi se repete uma vez por mês lunar. As janelas não são cortadas nos nasceres do sol intermediários, então uma ocorrência que se estende por dois dias civis é retornada como uma única linha.

https://api.occultapi.com/api/astro/tithi_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

Campo	Tipo	Obrigatório	Observações
timezone_as_float	number (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.
tithi_number	integer	obrigatório	min 1 · max 30
year	integer	obrigatório	Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400

Campo

Tipo

Obrigatório

Observações

timezone_as_float

number (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.

tithi_number

integer

obrigatório

min 1 · max 30

year

integer

obrigatório

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

min 1800 · max 2400

Exemplo de requisição

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

Resposta

{
  "data": {
    "year": 2026,
    "tithi_number": 1,
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T20:45:19+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-18T11:28:41+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T23:23:24+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-18T08:41:36+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T16:11:46+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T23:01:51+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-15T06:21:58+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T15:12:30+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-12T02:17:22+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T16:02:05+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-10T08:31:14+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-10T03:17:14+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.