/api/astro/shani_analysis/1 CreditSaturn-Transitphasen
Auf seinem langsamen Umlauf durch den Tierkreis durchläuft Saturn vier benannte Phasen, die die indische Astrologie genau verfolgt; alle werden vom Radix-Mond oder vom Radix-Aszendenten aus gemessen: Sade Sati, die siebeneinhalb Jahre rund um Saturns Durchgang über diesen Punkt; Ashtama Shani, Saturn im 8. Haus davon; Kantaka Shani, Saturn im 4., 7. oder 10. Haus; und Dhaiya, auch Ardhashtama genannt, Saturn im 4. oder 8. Haus. Dieser Endpoint gibt für einen beliebigen Zeitpunkt an, ob die jeweilige Phase läuft, wann sie endet und wann die nächste beginnt. Sende zwei Horoskope: die Geburtsdaten als `date_time_natal`, `latitude_natal`, `longitude_natal` und `chart_name_natal` und den gefragten Zeitpunkt über die entsprechenden `_transit`-Felder. `ref_celestial` legt fest, ob die Phasen vom Radix-Mond oder vom Radix-Aszendenten aus gemessen werden. `mode` bestimmt, wie streng geprüft wird – 0 prüft die Stellung in Ganzzeichenhäusern, höhere Werte prüfen stattdessen ein Gradfenster um den Bezugspunkt und liefern deutlich engere Beginn- und Enddaten. Die Antwort enthält acht Objekte. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` und `sade_sati_shani` sind jeweils `{status, end_date}`: ein boolescher Wert, ob die Phase zum Transitzeitpunkt läuft, und, falls ja, ein Enddatum in ISO 8601 UTC, sonst null. `next_ashtama_shani`, `next_kantaka_shani` und `next_dhaiya_shani` sind `{date, ref_house_from_natal}`: wann das nächste Auftreten beginnt und welches Haus ab dem Bezugspunkt es auslöst; `next_sade_sati_shani` liefert nur `{date}`. Die Vorwärtssuche reicht hundert Jahre ab dem Transitzeitpunkt. Da Kantaka und Dhaiya beide das 4. Haus umfassen, melden sie oft dieselben Daten. Das ist so gewollt und kein Duplikat.
https://api.occultapi.com/api/astro/shani_analysis/Authentifizierung
Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonFelder der Anfrage
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| chart_name_natal | string | Pflicht | |
| chart_name_transit | string | Pflicht | |
| date_time_natal | string (date-time) | Pflicht | |
| date_time_transit | string (date-time) | Pflicht | |
| latitude_natal | number (double) | Pflicht | min -180 · max 180 |
| latitude_transit | number (double) | Pflicht | min -180 · max 180 |
| longitude_natal | number (double) | Pflicht | min -180 · max 180 |
| longitude_transit | number (double) | Pflicht | min -180 · max 180 |
| mode | integer | Pflicht | |
| ref_celestial | string | Pflicht | ascendantmoon |
Beispielanfrage
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}'Antwort
{
"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
}Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.
Fehler
Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.