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

Varredura de karana

Um karana é metade de um tithi — seis graus de afastamento entre a Lua e o Sol, cerca de onze a treze horas. Há onze nomes: sete móveis, que se repetem oito vezes cada um ao longo de um mês lunar, e quatro fixos, que ocorrem uma vez cada. Vishti, mais conhecido como Bhadra, é o karana a evitar. Este endpoint encontra todas as ocorrências de um karana específico ao longo de um ano civil inteiro, para que você monte uma lista do tipo 'quando é o próximo Vishti' sem percorrer o ano dia a dia. Passe karana_name exatamente como está grafado na lista do campo (diferencia maiúsculas de minúsculas), year e timezone_as_float; o deslocamento define onde o ano local começa e termina. Latitude e longitude não são necessárias, porque um karana é uma grandeza puramente lunar. A resposta é {year, karana_name, rows}, em que rows é uma lista cronológica de timestamps {start, end} em UTC. Um karana fixo gera cerca de doze linhas por ano; um móvel, perto de cem. Para os karanas de um único dia, use a chave karana_segments de /api/astro/panchanga/.

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

karana_name

string

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

obrigatório

KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga

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.

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/karana_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"karana_name":"Kimstughna","timezone_as_float":5.5,"year":2026}'

Resposta

{
  "data": {
    "year": 2026,
    "karana_name": "Kimstughna",
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T08:22:04+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-17T23:48:42+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T12:26:49+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-17T22:18:56+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T06:07:05+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T12:57:08+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-14T20:00:36+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T04:21:33+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-11T14:48:43+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T03:52:40+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-09T19:43:50+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-09T14:03:05+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.