curl -X POST https://api.occultapi.com/api/astro/panchanga_yogas/ \
-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}'Un yoga du panchanga est une qualité nommée, bonne ou mauvaise, que porte toute une journée et qui naît de la combinaison du jour lunaire (tithi), du jour de la semaine (vaara) et de la demeure lunaire (nakshatra) de ce jour. Sarvartha Siddhi (« tous les desseins réussissent »), Amrit Siddhi, Tripushkara, Dagdha, Mrityu et Yamaghanta sont les plus connus. La pratique du muhurta s’en sert comme premier filtre : choisir un jour qui porte une combinaison bénéfique et éviter ceux qui en portent une maléfique. Cet endpoint fait le balayage jour par jour : il parcourt chaque jour civil de l’année demandée, évalue les yogas une fois, au lever du soleil, et ne renvoie que les jours qui en portent au moins un. La réponse est `data.days`, une liste de `{date, yogas}` où `date` est au format `YYYY-MM-DD` et `yogas` une liste de noms ; les jours sans aucun yoga sont entièrement omis. La plupart des noms indiquent entre parenthèses la convention dont ils proviennent, par exemple "Amrit Yoga (Vaara Tithi Yoga)" ou "Padma Yoga (Vashishta Samhita Yogas)", car plusieurs textes classiques définissent des ensembles qui se recoupent. Les yogas sont lus au lever du soleil : latitude, longitude et `timezone_as_float` influent donc tous trois sur le résultat. `use_28_nakshatras` vaut true par défaut et insère Abhijit comme nakshatra à part entière ; certains yogas, comme le Kaana Yoga du lundi, sont définis par rapport à Abhijit et ne peuvent pas apparaître sans lui. Mettez-le à false pour utiliser la liste standard de 27 nakshatras. Cet endpoint n’a aucun rapport avec `/api/astro/yogas/`, qui recherche des combinaisons de planètes dans un thème natal ; ici, aucun thème natal n’intervient. Pour le Ravi Yoga en particulier, `/api/astro/ravi_yoga/` donne les heures exactes de début et de fin plutôt qu’un simple indicateur par jour.
| 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 1800 · max 2400 |
| use_28_nakshatras | boolean | facultatif |