Chargement du Playground
curl -X POST https://api.occultapi.com/api/astro/festival/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["calculate_festivals"],"moon_option":"amavas","year":2025,"date_time":"2025-02-12T08:35:00.795Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Toutes les fêtes hindoues d’une année civile, calculées de A à Z pour le lieu que vous indiquez, ainsi que les ekadashis et les observances jaïnes, sikhes et chrétiennes que suit le moteur. Contrairement aux endpoints de calendriers régionaux, qui renvoient une liste sélectionnée par tradition, celui-ci fournit l’ensemble pan-indien complet, avec pour chaque entrée la plage exacte de sa tithi. L’année est parcourue tithi par tithi, et non jour par jour : une tithi de moins de vingt-quatre heures ne peut donc pas passer inaperçue, et une tithi longue ne peut pas être comptée deux fois. `moon_option` détermine le nom des mois lunaires : 'poornima' utilise directement le mois purnimanta, tandis que toute autre valeur — y compris 'amavas' — part du mois amanta et le convertit, comme le font la plupart des panchangs nord-indiens imprimés. Envoyez `year`, `date_time` et le lieu. Chaque entrée indique le début et la fin de la tithi qui la régit, et non une date unique : c’est donc à vous de choisir le jour civil où l’afficher. Si vous préférez que ce choix soit fait pour vous, utilisez l’un des endpoints de calendriers régionaux, qui placent chaque observance au jour où elle est effectivement célébrée.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| date_time | string (date-time) | obligatoire | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes. Contrainte de FORMAT. DateTimeField DRF : ISO-8601 uniquement (formats d’entrée par défaut de DRF), p. ex. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sans fuseau = UTC supposé). |
| keys | array | obligatoire | Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. calculate_festivalsTableau de chaînes ; il n’existe qu’une seule clé. |
| 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. min -89.9 · max 89.9 |
| 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. min -180 · max 180 |
| moon_option | string | obligatoire | amavaspoornimaSensible à la casse, en minuscules. 'poornima' utilise directement le mois lunaire purnimanta ; TOUTE autre valeur - y compris 'amavas' et n’importe quelle faute de frappe - passe dans la branche else (mois amanta converti en purnimanta), si bien qu’une faute de frappe équivaut, sans avertissement, à 'amavas'. Transmis à. |
| 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é. min -12 · max 14 |
| year | integer | obligatoire | Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. |
Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.
| Clé | Champs supplémentaires requis | Description | |
|---|---|---|---|
| calculate_festivals | year | Les observances de toute l’année, sous forme d’objet à cinq listes : `festivals`, `ekadashis`, `jain_festivals`, `sikh_festivals` et `christian_festivals`. Chaque entrée donne le nom de la fête, le début (`start`) et la fin (`end`) de la tithi qui la régit, sous forme de chaînes d’horodatage UTC, et le mois lunaire (`month`) ; les entrées d’ekadashi donnent aussi le `paksha`. Prend `year`. |