/api/astro/shani_analysis/1 créditPhases du transit de Saturne
Au fil de son lent parcours du zodiaque, Saturne traverse quatre phases nommées que l’astrologie indienne suit de près, toutes mesurées à partir de la Lune natale ou de l’ascendant natal : la Sade Sati, les sept ans et demi qui entourent le passage de Saturne sur ce point ; Ashtama Shani, Saturne en huitième position à partir de ce point ; Kantaka Shani, Saturne en quatrième, septième ou dixième ; et Dhaiya, aussi appelé Ardhashtama, Saturne en quatrième ou huitième. Cet endpoint indique si chacune est en cours à un moment donné, quand elle se termine et quand commence la suivante. Envoyez deux thèmes : les données de naissance dans `date_time_natal`, `latitude_natal`, `longitude_natal` et `chart_name_natal`, et le moment qui vous intéresse dans les champs `_transit` correspondants. `ref_celestial` indique si les phases se mesurent à partir de la Lune natale ou de l’ascendant natal. `mode` règle la sévérité du test — 0 vérifie le placement en maisons en signes entiers ; les valeurs supérieures vérifient plutôt une plage de degrés autour du point de référence, ce qui donne des dates de début et de fin nettement plus serrées. La réponse contient huit objets. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` et `sade_sati_shani` sont chacun de la forme `{status, end_date}` : un booléen qui indique si la phase est en cours au moment du transit, et une date de fin ISO 8601 en UTC si c’est le cas, ou null sinon. `next_ashtama_shani`, `next_kantaka_shani` et `next_dhaiya_shani` sont de la forme `{date, ref_house_from_natal}` : la date de début de la prochaine occurrence et la maison, comptée à partir du point de référence, qui la déclenche ; `next_sade_sati_shani` ne donne que `{date}`. La recherche vers l’avant couvre cent ans à partir du moment du transit. Comme Kantaka et Dhaiya incluent tous deux la quatrième maison, les deux indiquent souvent les mêmes dates. C’est normal, ce n’est pas un doublon.
https://api.occultapi.com/api/astro/shani_analysis/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 |
|---|---|---|---|
| chart_name_natal | string | obligatoire | |
| chart_name_transit | string | obligatoire | |
| date_time_natal | string (date-time) | obligatoire | |
| date_time_transit | string (date-time) | obligatoire | |
| latitude_natal | number (double) | obligatoire | min -180 · max 180 |
| latitude_transit | number (double) | obligatoire | min -180 · max 180 |
| longitude_natal | number (double) | obligatoire | min -180 · max 180 |
| longitude_transit | number (double) | obligatoire | min -180 · max 180 |
| mode | integer | obligatoire | |
| ref_celestial | string | obligatoire | ascendantmoon |
Exemple de requête
curl -X POST https://api.occultapi.com/api/astro/shani_analysis/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time_natal":"2025-11-21T05:41:58.124Z","date_time_transit":"2024-11-21T05:41:58.124Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"ascendant","mode":0}'Réponse
{
"data": {
"ashtama_shani": {
"status": false,
"end_date": null
},
"kantaka_shani": {
"status": false,
"end_date": null
},
"dhaiya_shani": {
"status": false,
"end_date": null
},
"sade_sati_shani": {
"status": true,
"end_date": "2025-03-09T10:21:25Z"
},
"next_ashtama_shani": {
"date": "2036-08-08T03:38:39Z",
"ref_house_from_natal": 8
},
"next_kantaka_shani": {
"date": "2027-05-11T00:01:56Z",
"ref_house_from_natal": 4
},
"next_dhaiya_shani": {
"date": "2027-05-11T00:01:56Z",
"ref_house_from_natal": 4
},
"next_sade_sati_shani": {
"date": "2046-02-22T02:59:10Z"
}
},
"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.