/api/astro/malayalam_calendar/1 créditCalendrier malayalam
Une année d’observances du Kerala selon le calendrier malayalam (ère Kollam), qui est solaire : les mois commencent à l’entrée du Soleil dans chaque signe sidéral, et l’année s’ouvre au Chingam Sankramam en août. La liste couvre les douze Sankramams, les fêtes de temple et vratas du Kerala — Thiruvathira, Makaravilakku, Attukal Pongal, Painkuni Uthram, Guruvayur Ekadasi, le début du Mandalakala — et les jours pan-indiens tels qu’on les y observe. Passez year avec latitude, longitude et le décalage UTC. La réponse est {year, events}, chaque événement étant {name, date}, par ordre chronologique ; une année type renvoie une cinquantaine d’entrées. L’année doit être comprise entre 2006 et 2046. Onam y figure comme une seule entrée datée. Pour la semaine de fête jour par jour, avec les horaires des nakshatras et les numéros de jour malayalam, utilisez /api/astro/onam_calendar/.
https://api.occultapi.com/api/astro/malayalam_calendar/
Authentification
Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonChamps de la requête
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| latitude | number (double) | obligatoire | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. |
| longitude | number (double) | obligatoire | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. |
| timezone_as_float | number (double) | obligatoire | Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. |
| year | integer | obligatoire | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. min 2006 · max 2046 |
Exemple de requête
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}'Réponse
{
"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
}Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.
Erreurs
Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.