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

Varredura anual do Nitya Yoga

O Nitya Yoga é a vigésima sétima parte do círculo formada pela soma das longitudes siderais do Sol e da Lua. Cada um dos vinte e sete — de Vishkambha a Vaidhriti — dura um pouco menos de um dia, e eles importam na astrologia eletiva: Vyatipata, Vaidhriti, Parigha, Vyaghata, Shoola, Ganda e Atiganda são tradicionalmente evitados, enquanto os yogas Siddhi, Siddha, Shubha, da classe Amrita e Sukarma são buscados. Este endpoint recebe um yoga pelo nome e retorna todas as ocorrências dele em um ano civil. `yoga_name` diferencia maiúsculas de minúsculas e deve corresponder exatamente ao enum. `year` e `timezone_as_float` definem o ano local a cobrir, e não são necessárias coordenadas, porque o yoga muda no mesmo instante em todo lugar. Como a soma das duas longitudes avança cerca de 13 graus e 20 minutos a cada 22.6 horas, cada yoga se repete cerca de catorze ou quinze vezes por ano. A resposta é `{year, yoga_name, rows}`, em que `rows` é uma lista cronológica de `{start, end}` com timestamps ISO em UTC. Cada par é o instante real de início e de fim daquele yoga, encontrado por bisseção da soma das longitudes do Sol e da Lua, e não por amostragem no nascer do sol, então os limites têm precisão de uma fração de segundo.

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

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.
year	integer	obrigatório	Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400
yoga_name	string	obrigatório	`VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva`

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

yoga_name

string

obrigatório

VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva

Exemplo de requisição

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

Resposta

{
  "data": {
    "year": 2026,
    "yoga_name": "Vishkambha",
    "rows": [
      {
        "start": "2026-01-04T20:17:27.999999+00:00",
        "end": "2026-01-05T17:17:16.999999+00:00"
      },
      {
        "start": "2026-01-30T11:28:35.999999+00:00",
        "end": "2026-01-31T08:03:35.999999+00:00"
      },
      {
        "start": "2026-02-24T22:56:20.999999+00:00",
        "end": "2026-02-25T19:58:43.999999+00:00"
      },
      {
        "start": "2026-03-22T10:11:35.999999+00:00",
        "end": "2026-03-23T06:52:06.999999+00:00"
      },
      {
        "start": "2026-04-17T01:51:55.999999+00:00",
        "end": "2026-04-17T22:15:28.999999+00:00"
      },
      {
        "start": "2026-05-12T17:49:31.999999+00:00",
        "end": "2026-05-13T15:24:49.999999+00:00"
      },
      {
        "start": "2026-06-07T04:31:57.999999+00:00",
        "end": "2026-06-08T03:58:13.999999+00:00"
      },
      {
        "start": "2026-07-02T11:09:21.999999+00:00",
        "end": "2026-07-03T11:30:01.999999+00:00"
      },
      {
        "start": "2026-07-27T17:24:55.999999+00:00",
        "end": "2026-07-28T18:03:37.999999+00:00"
      },
      {
        "start": "2026-08-21T23:48:40.999999+00:00",
        "end": "2026-08-23T00:44:33.999999+00:00"
      },
      {
        "start": "2026-09-16T06:52:40.999999+00:00",
        "end": "2026-09-17T07:19:46.999999+00:00"
      },
      {
        "start": "2026-10-11T15:35:35.999999+00:00",
        "end": "2026-10-12T15:02:25.999999+00:00"
      },
      {
        "start": "2026-11-05T23:39:40.999999+00:00",
        "end": "2026-11-06T22:40:11.999999+00:00"
      },
      {
        "start": "2026-12-01T06:45:12.999999+00:00",
        "end": "2026-12-02T05:01:50.999999+00:00"
      },
      {
        "start": "2026-12-26T18:52:33.999999+00:00",
        "end": "2026-12-27T15:23:47.999999+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.