Chargement du Playground
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}'Le calendrier télougou est luni-solaire amanta : les mois vont d’une nouvelle lune à la suivante et portent des noms télougous (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu et Phalgunamu) ; l’année se compte en Shaka Samvat et s’ouvre à Ugadi, le Chaithramu Shukla Padyami. Le calcul des mois, détection du mois adhika comprise, est le même que pour les calendriers marathi et kannada — ce qui distingue ces trois calendriers, c’est le nom des mois et la liste des fêtes, pas l’astronomie. Il ne suit pas le schéma solaire, de signe en signe, des calendriers tamoul et malayalam. Envoyez un `year` avec `latitude`, `longitude` et `timezone_as_float`. La réponse est `{year, events}` et chaque événement se réduit à `{name, date}` ; contrairement au calendrier tamoul, il n’y a pas de champs de mois ni de jour du mois. Comptez environ quatre-vingt-dix entrées par an : les vingt-quatre ekadashis (vingt-six les années à mois adhika) sous leurs noms télougous, avec les variantes Gauna et Vaishnava du lendemain que la plupart des autres calendriers régionaux omettent, environ vingt-cinq Pradosh Vrats nommés d’après leur jour de la semaine (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani), les douze Sankashtahara Chaturthis, les douze vratas de Shukla Dwadashi et les principales fêtes. Le lever et le coucher du soleil ainsi que la plage de Pradosha sont calculés pour les coordonnées que vous envoyez : dans une autre ville, une date peut donc se décaler d’un jour ; la règle du Pradosh Vrat, en particulier, rattache chaque Trayodashi au jour civil dont la plage de Pradosha, après le coucher du soleil, la recouvre le plus. Les fêtes communes avec le calendrier hindou principal sont lues dans la table précalculée, qui ne couvre que 2006-2046.
| 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 |