/api/astro/bengali_calendar/1 créditoCalendário bengali
O ano bengali correspondente a um ano gregoriano: Pohela Boishakh e o ano-novo solar, os doze Sankrantis, Durga Puja e o restante da sequência de outono, Kali Puja, Bhai Phonta, Jagaddhatri Puja e os festivais pan-indianos tal como Bengala os celebra. Nada vem de uma tabela fixa: tudo é calculado na hora para as coordenadas que você passar. Os festivais lunares são localizados pelo tithi e depois atribuídos ao dia civil em que são de fato observados, conforme o momento do dia que cada observância exige — o nascer do sol para alguns, o meio-dia para outros, a meia-noite para Maha Shivaratri. Assim, as datas coincidem com as que um panchang bengali imprimiria para aquela cidade. Envie `year` com `latitude`, `longitude` e `timezone_as_float`. A resposta é `{year, events}`, em que events é uma lista de `{name, date}` em ordem de data e `date` é uma data civil local simples no formato YYYY-MM-DD. Compare com /api/astro/assamese_calendar/, que tem boa parte destes festivais em comum, mas acrescenta os Bihus e as observâncias solares assamesas.
https://api.occultapi.com/api/astro/bengali_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/bengali_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": "Makara Sankranti",
"date": "2026-01-14"
},
{
"name": "Kumbha Sankranti",
"date": "2026-02-13"
},
{
"name": "Maha Shivaratri",
"date": "2026-02-15"
},
{
"name": "Meena Sankranti",
"date": "2026-03-15"
},
{
"name": "Rama Navami *Smarta",
"date": "2026-03-26"
},
{
"name": "Mesha Sankranti",
"date": "2026-04-14"
},
{
"name": "Solar New Year",
"date": "2026-04-14"
},
{
"name": "Pohela Boishakha",
"date": "2026-04-15"
},
{
"name": "Akshaya Tritiya",
"date": "2026-04-19"
},
{
"name": "Buddha Purnima",
"date": "2026-05-01"
},
{
"name": "Rabindranath Tagore Jayanti",
"date": "2026-05-09"
},
{
"name": "Vrishabha Sankranti",
"date": "2026-05-15"
},
{
"name": "Ganga Puja",
"date": "2026-05-25"
},
{
"name": "Mithuna Sankranti",
"date": "2026-06-15"
},
{
"name": "Karka Sankranti",
"date": "2026-07-16"
},
{
"name": "Ratha Jatra",
"date": "2026-07-16"
},
{
"name": "Guru Purnima",
"date": "2026-07-29"
},
{
"name": "Simha Sankranti",
"date": "2026-08-17"
},
{
"name": "Rakhi Bandhan",
"date": "2026-08-28"
},
{
"name": "Krishna Janmashtami",
"date": "2026-09-04"
},
{
"name": "Ganesh Chaturthi",
"date": "2026-09-14"
},
{
"name": "Kanya Sankranti",
"date": "2026-09-17"
},
{
"name": "Mahalaya",
"date": "2026-10-10"
},
{
"name": "Tula Sankranti",
"date": "2026-10-17"
},
{
"name": "Durga Ashtami",
"date": "2026-10-19"
},
{
"name": "Maha Navami",
"date": "2026-10-20"
},
{
"name": "Vijayadashami",
"date": "2026-10-21"
},
{
"name": "Lakshmi Puja",
"date": "2026-10-25"
},
{
"name": "Dhanteras",
"date": "2026-11-06"
},
{
"name": "Dipabali",
"date": "2026-11-08"
},
{
"name": "Kali Puja",
"date": "2026-11-08"
},
{
"name": "Bhai Phonta",
"date": "2026-11-11"
},
{
"name": "Vrishchika Sankranti",
"date": "2026-11-16"
},
{
"name": "Jagaddhatri Puja",
"date": "2026-11-18"
},
{
"name": "Dhanu Sankranti",
"date": "2026-12-16"
}
]
},
"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.