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

Janelas de Ravi yoga

O Ravi Yoga ocorre quando o nakshatra da Lua está a 4, 6, 9, 10, 13 ou 20 posições do nakshatra do Sol. É considerado uma janela auspiciosa que prevalece sobre um muhurta que, sem ele, seria desfavorável, e costuma ser usado para inaugurar uma casa nova, receber um veículo, abrir uma loja e atos pontuais semelhantes. Como depende apenas dos dois nakshatras, e não do dia lunar nem do dia da semana, pode ser fornecido como janelas contínuas com horários exatos, em vez de uma flag por dia. A resposta é `data.rows`, uma lista de timestamps `{start, end}` em ISO 8601 e em UTC que cobre o ano solicitado. As janelas são cortadas em cada nascer do sol que cai dentro delas: um intervalo contínuo de três dias aparece como três linhas consecutivas que se encontram nos instantes do nascer do sol, como faz o Drik Panchang. Para recuperar os intervalos originais, concatene as linhas adjacentes. Envie `year`, `latitude`, `longitude` e `timezone_as_float`. A localização afeta apenas os pontos de corte no nascer do sol, não o yoga em si. `/api/astro/panchanga_yogas/` informa o mesmo yoga como uma flag diária, junto com os yogas que dependem do tithi e do dia da semana; use este endpoint quando precisar dos horários exatos de início e fim.

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

Testar requisição

Dados de Janelas de Ravi yoga 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
latitude	number (double)	obrigatório	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)	obrigatório	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)	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.
end_date	string (date)	opcional
start_date	string (date)	opcional
year	integer	opcional	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/ravi_yoga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"rows\": [{\"start\": \"2026-01-01T17:18:35+00:00\", \"end\": \"2026-01-02T01:50:16+00:00\"}, {\"start\": \"2026-01-02T01:50:16+00:00\", \"end\": \"2026-01-02T14:34:10+00:00\"}, {\"start\": \"2026-01-08T06:54:39+00:00\", \"end\": \"2026-01-09T01:51:24+00:00\"}, {\"start\": \"2026-01-09T01:51:24+00:00\", \"end\": \"2026-01-09T08:10:56+00:00\"}, {\"start\": \"2026-01-25T02:19:01+00:00\", \"end\": \"2026-01-25T08:05:57+00:00\"}, {\"start\": \"2026-01-27T05:39:05+00:00\", \"end\": \"2026-01-28T01:48:11+00:00\"}, {\"start\": \"2026-01-28T01:48:11+00:00\", \"end\": \"2026-01-29T01:47:45+00:00\"}, {\"start\": \"2026-01-29T01:47:45+00:00\", \"end\": \"2026-01-29T02:01:52+00:00\"}, {\"start\": \"2026-01-30T21:57:34+00:00\", \"end\": \"2026-01-31T01:46:50+00:00\"}, {\"start\": \"2026-01-31T01:46:50+00:00\", \"end\": \"2026-01-31T20:04:13+00:00\"}, {\"start\": \"2026-02-07T20:58:37+00:00\", \"end\": \"2026-02-08T01:42:18+00:00\"}, {\"start\": \"2026-02-08T01:42:18+00:00\", \"end\": \"2026-02-08T23:32:55+00:00\"}, {\"start\": \"2026-02-20T14:37:39+00:00\", \"end\": \"2026-02-21T01:32:17+00:00\"}, {\"start\": \"2026-02-21T01:32:17+00:00\", \"end\": \"2026-02-21T13:37:16+00:00\"}, {\"start\": \"2026-02-22T12:24:48+00:00\", \"end\": \"2026-02-23T01:30:30+00:00\"}, {\"start\": \"2026-02-23T01:30:30+00:00\", \"end\": \"2026-02-23T11:03:45+00:00\"}, {\"start\": \"2026-02-25T08:08:55+00:00\", \"end\": \"2026-02-26T01:27:44+00:00\"}, {\"start\": \"2026-02-26T01:27:44+00:00\", \"end\": \"2026-02-27T01:26:47+00:00\"}, {\"start\": \"2026-02-27T01:26:47+00:00\", \"end\": \"2026-02-27T05:19:02+00:00\"}, {\"start\": \"2026-03-01T03:04:29+00:00\", \"end\": \"2026-03-02T01:23:52+00:00\"}, {\"start\": \"2026-03-02T01:23:52+00:00\", \"end\": \"2026-03-02T02:21:41+00:00\"}, {\"start\": \"2026-03-09T10:41:41+00:00\", \"end\": \"2026-03-10T01:15:40+00:00\"}, {\"start\": \"2026-03-10T01:15:40+00:00\", \"end\": \"2026-03-10T13:35:20+00:00\"}, {\"start\": \"2026-03-21T19:07:56+00:00\", \"end\": \"2026-03-22T01:02:41+00:00\"}, {\"start\": \"2026-03-22T01:02:41+00:00\", \"end\": \"2026-03-22T17:12:49+00:00\"}, {\"start\": \"2026-03-23T15:19:47+00:00\", \"end\": \"2026-03-24T01:00:29+00:00\"}, {\"start\": \"2026-03-24T01:00:29+00:00\", \"end\": \"2026-03-24T13:35:03+00:00\"}, {\"start\": \"2026-03-26T10:49:16+00:00\", \"end\": \"2026-03-27T00:57:11+00:00\"}, {\"start\": \"2026-03-27T00:57:11+00:00\", \"end\": \"2026-03-28T00:56:05+00:00\"}, {\"start\": \"2026-03-28T00:56:05+00:00\", \"end\": \"2026-03-28T09:20:23+00:00\"}, {\"start\": \"2026-03-30T09:18:08+00:00\", \"end\": \"2026-03-31T00:52:48+00:00\"}, {\"start\": \"2026-03-31T00:52:48+00:00\", \"end\": \"2026-03-31T09:51:03+00:00\"}, {\"start\": \"2026-03-31T14:40:06+00:00\", \"end\": \"2026-04-01T00:51:43+00:00\"}, {\"start\": \"2026-04-01T00:51:43+00:00\", \"end\": \"2026-04-01T10:47:41+00:00\"}, {\"start\": \"2026-04-08T00:24:04+00:00\", \"end\": \"2026-04-08T00:44:13+00:00\"}, {\"start\": \"2026-04-08T00:44:13+00:00\", \"end\": \"2026-04-09T00:43:10+00:00\"}, {\"start\": \"2026-04-09T00:43:10+00:00\", \"end\": \"2026-04-09T03:18:37+00:00\"}, {\"start\": \"2026-04-19T23:05:23+00:00\", \"end\": \"2026-04-20T00:32:13+00:00\"}, {\"start\": \"2026-04-20T00:32:13+00:00\", \"end\": \"2026-04-20T20:38:33+00:00\"}, {\"start\": \"2026-04-21T18:28:41+00:00\", \"end\": \"2026-04-22T00:30:22+00:00\"}, {\"start\": \"2026-04-22T00:30:22+00:00\", \"end\": \"2026-04-22T16:43:13+00:00\"}, {\"start\": \"2026-04-24T14:44:34+00:00\", \"end\": \"2026-04-25T00:27:40+00:00\"}, {\"start\": \"2026-04-25T00:27:40+00:00\", \"end\": \"2026-04-26T00:26:48+00:00\"}, {\"start\": \"2026-04-26T00:26:48+00:00\", \"end\": \"2026-04-26T14:57:21+00:00\"}, {\"start\": \"2026-04-29T18:46:34+00:00\", \"end\": \"2026-04-30T00:23:28+00:00\"}, {\"start\": \"2026-04-30T00:23:28+00:00\", \"end\": \"2026-04-30T20:46:58+00:00\"}, {\"start\": \"2026-05-07T13:15:59+00:00\", \"end\": \"2026-05-08T00:17:33+00:00\"}, {\"start\": \"2026-05-08T00:17:33+00:00\", \"end\": \"2026-05-08T09:13:55+00:00\"}, {\"start\": \"2026-05-19T03:11:45+00:00\", \"end\": \"2026-05-20T00:10:54+00:00\"}, {\"start\": \"2026-05-20T00:10:54+00:00\", \"end\": \"2026-05-20T00:42:03+00:00\"}, {\"start\": \"2026-05-20T22:42:18+00:00\", \"end\": \"2026-05-21T00:10:29+00:00\"}, {\"start\": \"2026-05-21T00:10:29+00:00\", \"end\": \"2026-05-21T21:19:37+00:00\"}, {\"start\": \"2026"
}

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.