/api/astro/malayalam_calendar/1 créditoCalendário malaiala
Um ano de observâncias de Kerala no calendário malaiala (era Kollam), que é solar: os meses começam com a entrada do Sol em cada signo sideral, e o ano se inicia em Chingam Sankramam, em agosto. A lista abrange os doze Sankramams, os festivais dos templos de Kerala e os vratas — Thiruvathira, Makaravilakku, Attukal Pongal, Painkuni Uthram, Guruvayur Ekadasi, o início do Mandalakala — e os dias pan-indianos tal como são observados ali. Passe o ano com latitude, longitude e deslocamento UTC. A resposta é {year, events}, cada evento {name, date}, em ordem de data; um ano típico retorna cerca de cinquenta entradas. O ano deve estar entre 2006 e 2046. O Onam aparece aqui como uma única entrada datada. Para a semana do festival dia a dia, com os horários dos nakshatras e os números dos dias no calendário malaiala, use /api/astro/onam_calendar/.
https://api.occultapi.com/api/astro/malayalam_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/malayalam_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
{
"data": {
"year": 2026,
"events": [
{
"name": "Thiruvathira",
"date": "2026-01-03"
},
{
"name": "Makaram Sankramam",
"date": "2026-01-14"
},
{
"name": "Pongal",
"date": "2026-01-14"
},
{
"name": "Makaravilakku",
"date": "2026-01-14"
},
{
"name": "Thai Pooyam",
"date": "2026-02-01"
},
{
"name": "Kumbham Sankramam",
"date": "2026-02-13"
},
{
"name": "Shivarathri",
"date": "2026-02-15"
},
{
"name": "Attukal Pongal",
"date": "2026-02-23"
},
{
"name": "Meenam Sankramam",
"date": "2026-03-15"
},
{
"name": "Matsyavathara Dinam",
"date": "2026-03-21"
},
{
"name": "Shree Rama Navami *Smarta",
"date": "2026-03-26"
},
{
"name": "Painkuni Uthram",
"date": "2026-04-01"
},
{
"name": "Metam Sankramam",
"date": "2026-04-14"
},
{
"name": "Solar New Year",
"date": "2026-04-14"
},
{
"name": "Parashurama Jayanthi",
"date": "2026-04-19"
},
{
"name": "Akshaya Trithiya",
"date": "2026-04-19"
},
{
"name": "Shree Shankara Jayanthi",
"date": "2026-04-21"
},
{
"name": "Narasimha Jayanthi",
"date": "2026-04-30"
},
{
"name": "Chitra Pournami",
"date": "2026-05-01"
},
{
"name": "Kurmavathara Dinam",
"date": "2026-05-01"
},
{
"name": "Itavam Sankramam",
"date": "2026-05-15"
},
{
"name": "Mithunam Sankramam",
"date": "2026-06-15"
},
{
"name": "Karkatakam Sankramam",
"date": "2026-07-16"
},
{
"name": "Guru Poornima",
"date": "2026-07-29"
},
{
"name": "Chingam Sankramam",
"date": "2026-08-17"
},
{
"name": "Malayalam New Year",
"date": "2026-08-17"
},
{
"name": "Onam",
"date": "2026-08-26"
},
{
"name": "Ashtami Rohini",
"date": "2026-09-04"
},
{
"name": "Varaha Jayanthi",
"date": "2026-09-13"
},
{
"name": "Kerala Vinayaka Chathurthi",
"date": "2026-09-14"
},
{
"name": "Rishi Panchami",
"date": "2026-09-15"
},
{
"name": "Kanni Sankramam",
"date": "2026-09-17"
},
{
"name": "Vishwakarma Puja",
"date": "2026-09-17"
},
{
"name": "Vamana Jayanthi",
"date": "2026-09-23"
},
{
"name": "Navarathri",
"date": "2026-10-11"
},
{
"name": "Thulam Sankramam",
"date": "2026-10-17"
},
{
"name": "Durgashtami",
"date": "2026-10-19"
},
{
"name": "Maha Navami",
"date": "2026-10-20"
},
{
"name": "Vijayadashami",
"date": "2026-10-21"
},
{
"name": "Vidyarambham Day",
"date": "2026-10-21"
},
{
"name": "Diwali",
"date": "2026-11-08"
},
{
"name": "Vrischikam Sankramam",
"date": "2026-11-16"
},
{
"name": "Mandalakala Begins",
"date": "2026-11-16"
},
{
"name": "Guruvayur Ekadasi",
"date": "2026-11-20"
},
{
"name": "Karthigai Deepam",
"date": "2026-11-24"
},
{
"name": "Dhanu Sankramam",
"date": "2026-12-16"
},
{
"name": "Mukkoti Ekadasi",
"date": "2026-12-20"
},
{
"name": "Geeta Dinam",
"date": "2026-12-20"
},
{
"name": "Thiruvathira",
"date": "2026-12-24"
},
{
"name": "Mandalakala Pooja",
"date": "2026-12-26"
}
]
},
"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.