/api/astro/telugu_calendar/1 créditoCalendário telugu
O calendário telugu é lunissolar Amanta: os meses vão de uma lua nova à seguinte, têm nomes em telugu (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu e Phalgunamu), e o ano é contado em Shaka Samvat e começa em Ugadi, no Chaithramu Shukla Padyami. A aritmética de meses subjacente, incluindo a detecção do mês adhika, é a mesma que os calendários marathi e kannada usam — a diferença entre esses três está nos nomes dos meses e na lista de festivais, não na astronomia. Não é o esquema solar de signo a signo dos calendários tâmil e malaiala. Envie um `year` com `latitude`, `longitude` e `timezone_as_float`. A resposta é `{year, events}` e cada evento é apenas `{name, date}`; ao contrário do calendário tâmil, não há campos de mês nem de dia do mês. Espere cerca de noventa entradas por ano: os vinte e quatro Ekadashis (vinte e seis em um ano adhika) com seus nomes em telugu, junto com as alternativas Gauna e Vaishnava do dia seguinte que a maioria dos outros calendários regionais omite, aproximadamente vinte e cinco Pradosh Vrats nomeados pelo dia da semana (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), os doze Sankashtahara Chaturthis, os doze vratas de Shukla Dwadashi e os principais festivais. O nascer do sol, o pôr do sol e a janela de Pradosha são calculados para as coordenadas que você envia, então uma cidade diferente pode mover uma data em um dia; a regra do Pradosh Vrat, em particular, atribui cada Trayodashi ao dia civil cuja janela de Pradosha, após o pôr do sol, tem a maior sobreposição com ele. Os festivais compartilhados com o calendário hindu principal são lidos da tabela pré-calculada, que cobre apenas 2006-2046.
https://api.occultapi.com/api/astro/telugu_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/telugu_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, \"events\": [{\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Lambodara Sankashtahara\", \"date\": \"2026-01-06\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Bhishma Dwadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Dwijapriya Sankashtahara\", \"date\": \"2026-02-05\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Trayodashi\", \"date\": \"2026-02-14\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Narasimha Dwadashi\", \"date\": \"2026-02-28\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chhoti Holi\", \"date\": \"2026-03-03\"}, {\"name\": \"Holika Dahan\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-04\"}, {\"name\": \"Bhalachandra Sankashtahara\", \"date\": \"2026-03-06\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ugadi\", \"date\": \"2026-03-19\"}, {\"name\": \"Dola Gowri Vratam\", \"date\": \"2026-03-21\"}, {\"name\": \"Andolana Trutiya\", \"date\": \"2026-03-21\"}, {\"name\": \"Shree Ramanavami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Vamana Dwadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Madana Pournami\", \"date\": \"2026-04-02\"}, {\"name\": \"Vikata Sankashtahara\", \"date\": \"2026-04-05\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Akshaya Trutiya\", \"date\": \"2026-04-19\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Parashurama Dwadashi\", \"date\": \"2026-04-28\"}, {\"name\": \"Ekadanta Sankashtahara\", \"date\": \"2026-05-05\"}, {\"name\": \"Hanuman Jayanthi\", \"date\": \"2026-05-12\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Adhika Ramalakshmana Dwadashi\", \"date\": \"2026-05-27\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Vibhuvana Sankashtahara\", \"date\": \"2026-06-03\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Ramalakshmana Dwadashi\", \"date\": \"2026-06-26\"}, {\"name\": \"Shani Trayodashi\", \"date\": \"2026-06-27\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Krishnapingala Sankashtahara\", \"date\": \"2026-07-03\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Vaishnava Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Vasudeva Dwadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Gajanana Sankashtahara\", \"date\": \"2026-08-02\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Shravana Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Vaishnava Shravana Putrada Ekadashi\", \"date\": \"2026-08-24\"}, {\"name\": \"Damodara Dwadashi\", \"date\": \"2026-08-24\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Varalakshmi Vratam\", \"date\": \"2026-08-28\"}, {\"name\": \"Raksha Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Heramba Sankashtahara\", \"date\": \"2026-08-31\"}, {\"name\": \"Krishna Janmashtami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Parivartani Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Kalki Dwadashi\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\":"
}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.