/api/astro/onam_calendar/1 créditoCalendário de Onam
O Onam não é um único dia, mas uma sequência vinculada a nakshatras consecutivos, que vai de Atham (Hasta), passando por Thiruvonam, até Chathayam. Este endpoint retorna essa janela inteira para um determinado ano, uma linha por dia civil. Cada linha traz day_number, a data gregoriana, o dia da semana em inglês e na escrita malaiala, o nakshatra regente, o mês e o dia malaialas com o ano da era Kollam, uma lista captions que nomeia o que é observado naquele dia (Atthachamayam, Athapoo Pookalam, Vallam Kali e assim por diante), uma flag is_repeat_day e segments, com os instantes exatos de início e de fim do nakshatra na hora local. A contagem de dias não é fixa. Um nakshatra longo o suficiente para abranger dois nasceres do sol produz um dia repetido — mesmo nome, captions vazio, início e fim null — e prolonga a sequência; um curto pode, em vez disso, ser mesclado ao dia seguinte, que então traz dois nomes em captions. É normal haver doze ou treze linhas. Passe o ano com latitude, longitude e deslocamento UTC; o ano deve estar entre 2006 e 2046. Para ter o Onam como uma única entrada datada entre os festivais de Kerala de um ano inteiro, use /api/astro/malayalam_calendar/.
https://api.occultapi.com/api/astro/onam_calendar/
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/jsonCampos 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. |
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 2006 · max 2046 |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/onam_calendar/ \
-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, \"days\": [{\"day_number\": 1, \"date\": \"2026-08-16\", \"weekday_en\": \"Sunday\", \"weekday_ml\": \"ഞായറാഴ്ച\", \"nakshatra\": \"Atham\", \"malayalam_month\": \"Karkatakam\", \"malayalam_day\": 31, \"kollam_year\": 1201, \"captions\": [\"Atthachamayam\", \"Athapoo Pookalam\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Atham\", \"begin\": \"2026-08-16T03:25:45+05:30\", \"end\": \"2026-08-17T03:50:52+05:30\"}]}, {\"day_number\": 2, \"date\": \"2026-08-17\", \"weekday_en\": \"Monday\", \"weekday_ml\": \"തിങ്കളാഴ്ച\", \"nakshatra\": \"Chithira\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 1, \"kollam_year\": 1202, \"captions\": [\"Chithira Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Chithira\", \"begin\": \"2026-08-17T03:50:52+05:30\", \"end\": \"2026-08-18T04:58:59+05:30\"}]}, {\"day_number\": 3, \"date\": \"2026-08-18\", \"weekday_en\": \"Tuesday\", \"weekday_ml\": \"ചൊവ്വാഴ്ച\", \"nakshatra\": \"Chothi\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 2, \"kollam_year\": 1202, \"captions\": [\"Chodhi Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Chothi\", \"begin\": \"2026-08-18T04:58:59+05:30\", \"end\": \"2026-08-19T06:47:04+05:30\"}]}, {\"day_number\": 4, \"date\": \"2026-08-19\", \"weekday_en\": \"Wednesday\", \"weekday_ml\": \"ബുധനാഴ്ച\", \"nakshatra\": \"Vishakham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 3, \"kollam_year\": 1202, \"captions\": [\"Vishakham Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Vishakham\", \"begin\": \"2026-08-19T06:47:04+05:30\", \"end\": \"2026-08-20T09:08:29+05:30\"}]}, {\"day_number\": 5, \"date\": \"2026-08-20\", \"weekday_en\": \"Thursday\", \"weekday_ml\": \"വ്യാഴാഴ്ച\", \"nakshatra\": \"Vishakham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 4, \"kollam_year\": 1202, \"captions\": [], \"is_repeat_day\": true, \"segments\": [{\"name\": \"Vishakham\", \"begin\": null, \"end\": null}]}, {\"day_number\": 6, \"date\": \"2026-08-21\", \"weekday_en\": \"Friday\", \"weekday_ml\": \"വെള്ളിയാഴ്ച\", \"nakshatra\": \"Anizham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 5, \"kollam_year\": 1202, \"captions\": [\"Anizham Day\", \"Vallam Kali\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Anizham\", \"begin\": \"2026-08-20T09:08:29+05:30\", \"end\": \"2026-08-21T11:53:15+05:30\"}]}, {\"day_number\": 7, \"date\": \"2026-08-22\", \"weekday_en\": \"Saturday\", \"weekday_ml\": \"ശനിയാഴ്ച\", \"nakshatra\": \"Thrikketta\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 6, \"kollam_year\": 1202, \"captions\": [\"Thriketa Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Thrikketta\", \"begin\": \"2026-08-21T11:53:15+05:30\", \"end\": \"2026-08-22T14:49:28+05:30\"}]}, {\"day_number\": 8, \"date\": \"2026-08-23\", \"weekday_en\": \"Sunday\", \"weekday_ml\": \"ഞായറാഴ്ച\", \"nakshatra\": \"Moolam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 7, \"kollam_year\": 1202, \"captions\": [\"Moolam Day, Onam Sadya\", \"Puli Kali, Kaikotti Kali\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Moolam\", \"begin\": \"2026-08-22T14:49:28+05:30\", \"end\": \"2026-08-23T17:44:53+05:30\"}]}, {\"day_number\": 9, \"date\": \"2026-08-24\", \"weekday_en\": \"Monday\", \"weekday_ml\": \"തിങ്കളാഴ്ച\", \"nakshatra\": \"Pooradam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 8, \"kollam_year\": 1202, \"captions\": [\"Pooradam Day, Onathappan\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Pooradam\", \"begin\": \"2026-08-23T17:44:53+05:30\", \"end\": \"2026-08-24T20:28:27+05:30\"}]}, {\"day_number\": 10, \"date\": \"2026-08-25\", \"weekday_en\": \"Tuesday\", \"weekday_ml\": \"ചൊവ്വാഴ്ച\", \"nakshatra\": \"Uthradam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 9, \"kollam_year\": 1202, \"captions\": [\"Uthradom Day, First Onam\", \"Uthradappachil\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Uthradam\", \"begin\": \"2026-08-24T20:28:27+05:30\", \"end\": \"2026-08-25T22:51:30+05:30\"}]}, {\"day_number\": 11, \"date\": \"2026-08-26\", \"weekday_en\": \"Wednesday\", \"weekday_ml\": \"ബുധനാഴ്ച\", \"nakshatra\": \"Thiruvonam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 10, \"kollam_year\": 1202, \"captions\": [\"Thiruvonam Day, Second Onam\", \"Thiru-Onam, Onam\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Thiruvonam\", \"begin\": \"2026-08-25T22:51:30+05:30\", \"end\": \"2026-08-27T00:48:15+05:3"
}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.