/api/astro/nepali_calendar/1 créditoCalendário nepalês
Um ano de festivais e observâncias nepaleses no calendário Bikram Sambat. O calendário nepalês é solar — doze meses, cada um começando com a entrada do Sol em um signo sideral, sendo Baishakh o primeiro — e a resposta informa o ano Bikram Sambat, ou o par de anos, que abrange o ano gregoriano solicitado. A lista de eventos cobre cada Sankranti com seu nome nepalês (Maghe, Falgun, Baishakh e assim por diante), todos os Ekadashis, os dois Pradosh Vrats de cada mês, com o nome do respectivo dia da semana, os eclipses e festivais nacionais como Nawa Barsha e Bisket Jatra. Passe o ano com latitude, longitude e deslocamento UTC — atenção: a hora padrão do Nepal é UTC+05:45, então timezone_as_float deve ser 5.75 para Catmandu; com 5.5, os limites do dia se deslocam. A resposta é {year, bikram_sambat, events}, com cada evento no formato {name, date}. O ano deve estar entre 2006 e 2046. A regra de início do mês segue a prática de datar um Sankranti no dia do trânsito quando ele ocorre antes do pôr do sol desse dia e, caso contrário, no dia seguinte. No Nepal, os inícios de mês oficiais são definidos por um comitê, e não por um único critério astronômico; por isso, alguns poucos trânsitos por década não vão coincidir com o Patro publicado.
https://api.occultapi.com/api/astro/nepali_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/nepali_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, \"bikram_sambat\": \"2082 - 2083\", \"events\": [{\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Maghe Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Sat-Tila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Shree Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Bhima Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Falgun Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Fagu Poornima\", \"date\": \"2026-03-03\"}, {\"name\": \"Chaitra Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ram Nawami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Hanuman Jayenti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Baruthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Baishakh Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Nawa Barsha\", \"date\": \"2026-04-14\"}, {\"name\": \"Bisket Jatra\", \"date\": \"2026-04-14\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Parasuram Jayenti\", \"date\": \"2026-04-19\"}, {\"name\": \"Aachya Tritiya\", \"date\": \"2026-04-20\"}, {\"name\": \"Sita Jayanti\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Buddha Jayanti\", \"date\": \"2026-05-01\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Jeshta Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Asar Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Shrawane Sankranti\", \"date\": \"2026-07-17\"}, {\"name\": \"Harisayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Bhadra Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Janai Purnima\", \"date\": \"2026-08-28\"}, {\"name\": \"Kwati Punhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakshya Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Gai Jatra\", \"date\": \"2026-08-29\"}, {\"name\": \"Shree Krishna Janmastami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Rishi Panchami\", \"date\": \"2026-09-15\"}, {\"name\": \"Ashoj Sankranti\", \"date\": \"2026-09-17\"}, {\"name\": \"Bishwakarma Pooja\", \"date\": \"2026-09-17\"}, {\"name\": \"Radhastami\", \"date\": \"2026-09-19\"}, {\"name\": \"Hari-Parivartan Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Indra Jatra\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-09-24\"}, {\"name\": \"Pitrupaksha Arambha\", \"date\": \"2026-09-27\"}, {\"name\": \"Pratiprada Shradham\", \"date\": \"2026-09-27\"}, {\"name\": \"Indira Ekadashi\", \"date\": \"2026-10-06\"}, {\"name\": \"Guru "
}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.