/api/astro/odia_calendar/1 créditoCalendário odia
Um ano de festivais odia (oriá) no calendário da era Vilayati. A lista se concentra em três grupos: os doze Sankrantis com seus nomes em odia — Mahabisuba Pana, Brusha, Raja, Dakhinaya Karkata, Singha, Garbhana e os demais —, todos os Ekadashis com nomes em odia, como Sattila, Pankoddhar, Jala Krida, Khalilagi e Kaliyadalan, e os principais festivais lunares: Rath Yatra, Gamha Purnima, Savitri Amabasya, Mahastami e Dasahara. Passe o ano com latitude, longitude e deslocamento UTC. A resposta é {year, events}, com cada evento no formato {name, date}, em ordem de data. O ano deve estar entre 2006 e 2046. Em um ano com mês adhika (intercalar), o par de Ekadashis desse mês se chama Sarvasammata Padmini e Sarvasammata Parama, seguindo o uso odia.
https://api.occultapi.com/api/astro/odia_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/odia_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": "Uttarayana Makar Sankranti",
"date": "2026-01-14"
},
{
"name": "Sattila Ekadashi",
"date": "2026-01-14"
},
{
"name": "Sri Panchami",
"date": "2026-01-23"
},
{
"name": "Bhouma Ekadashi",
"date": "2026-01-29"
},
{
"name": "Magha Purnima",
"date": "2026-02-01"
},
{
"name": "Kumbha Sankranti",
"date": "2026-02-13"
},
{
"name": "Pankoddhar Ekadashi",
"date": "2026-02-13"
},
{
"name": "Maha Shivaratri",
"date": "2026-02-15"
},
{
"name": "Papanasini Ekadashi",
"date": "2026-02-27"
},
{
"name": "Chhoti Holi",
"date": "2026-03-03"
},
{
"name": "Holika Dahan",
"date": "2026-03-03"
},
{
"name": "Holi",
"date": "2026-03-04"
},
{
"name": "Meena Sankranti",
"date": "2026-03-15"
},
{
"name": "Papamochani Ekadashi",
"date": "2026-03-15"
},
{
"name": "Rama Navami *Smarta",
"date": "2026-03-26"
},
{
"name": "Kamada Ekadashi",
"date": "2026-03-29"
},
{
"name": "Baruthini Ekadashi",
"date": "2026-04-13"
},
{
"name": "Mahabisuba Pana Sankranti",
"date": "2026-04-14"
},
{
"name": "Akshaya Tritiya",
"date": "2026-04-19"
},
{
"name": "Mohini Ekadashi",
"date": "2026-04-27"
},
{
"name": "Jala Krida Ekadashi",
"date": "2026-05-13"
},
{
"name": "Brusha Sankranti",
"date": "2026-05-15"
},
{
"name": "Savitri Amabasya",
"date": "2026-05-16"
},
{
"name": "Sarvasammata Parama Ekadashi",
"date": "2026-06-11"
},
{
"name": "Raja Sankranti",
"date": "2026-06-15"
},
{
"name": "Jamai Shashti",
"date": "2026-06-20"
},
{
"name": "Nirjala Ekadashi",
"date": "2026-06-25"
},
{
"name": "Khalilagi Ekadashi",
"date": "2026-07-10"
},
{
"name": "Dakhinaya Karkata Sankranti",
"date": "2026-07-16"
},
{
"name": "Rath Yatra",
"date": "2026-07-16"
},
{
"name": "Harishayan Ekadashi",
"date": "2026-07-25"
},
{
"name": "Kamika Ekadashi",
"date": "2026-08-09"
},
{
"name": "Singha Sankranti",
"date": "2026-08-17"
},
{
"name": "Shravana Putrada Ekadashi",
"date": "2026-08-23"
},
{
"name": "Gamha Purnima",
"date": "2026-08-28"
},
{
"name": "Krishna Janmashtami",
"date": "2026-09-04"
},
{
"name": "Kaliyadalan Ekadashi",
"date": "2026-09-07"
},
{
"name": "Ganesh Chaturthi",
"date": "2026-09-14"
},
{
"name": "Kanya Sankranti",
"date": "2026-09-17"
},
{
"name": "Parswa Paribartan Ekadashi",
"date": "2026-09-22"
},
{
"name": "Indira Ekadashi",
"date": "2026-10-06"
},
{
"name": "Mahalaya Amabasya",
"date": "2026-10-10"
},
{
"name": "Garbhana Sankranti",
"date": "2026-10-17"
},
{
"name": "Mahastami",
"date": "2026-10-19"
},
{
"name": "Dasahara",
"date": "2026-10-20"
},
{
"name": "Papankusha Ekadashi",
"date": "2026-10-22"
},
{
"name": "Rama Ekadashi",
"date": "2026-11-05"
},
{
"name": "Dhanteras",
"date": "2026-11-06"
},
{
"name": "Lakshmi Puja",
"date": "2026-11-08"
},
{
"name": "Dipavali",
"date": "2026-11-08"
},
{
"name": "Bichha Sankranti",
"date": "2026-11-16"
},
{
"name": "Deva Utthapan Ekadashi",
"date": "2026-11-20"
},
{
"name": "Kartika Purnima",
"date": "2026-11-24"
},
{
"name": "Utpanna Ekadashi",
"date": "2026-12-04"
},
{
"name": "Dhanu Sankranti",
"date": "2026-12-16"
},
{
"name": "Gomati Ekadashi",
"date": "2026-12-20"
}
]
},
"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.