POST/api/astro/shani_analysis/1 kredi

Satürn transit evreleri

Satürn zodyakı yavaşça dolaşırken, Hint astrolojisinin yakından izlediği dört evre oluşur. Hepsi doğum Ay'ından veya doğum yükseleninden itibaren ölçülür: Sade Sati, Satürn'ün bu noktanın üzerinden geçtiği dönemi kapsayan yedi buçuk yıl; Ashtama Shani, Satürn'ün bu noktadan sekizinci evde olması; Kantaka Shani, Satürn'ün dördüncü, yedinci veya onuncu evde olması; Ardhashtama olarak da bilinen Dhaiya ise Satürn'ün dördüncü veya sekizinci evde olması. Bu endpoint, belirli bir anda her evrenin sürüp sürmediğini, ne zaman biteceğini ve bir sonrakinin ne zaman başlayacağını bildirir. İki harita gönderin: doğum bilgilerini `date_time_natal`, `latitude_natal`, `longitude_natal` ve `chart_name_natal` alanlarında, sorguladığınız anı ise bunlara karşılık gelen `_transit` alanlarında. `ref_celestial`, evrelerin natal Ay'dan mı yoksa natal yükselenden mi ölçüleceğini belirler. `mode` testin ne kadar sıkı olacağını seçer: 0 tam burç (whole-sign) ev yerleşimine bakar; daha yüksek değerler ise referans noktası çevresindeki bir derece aralığını test eder ve belirgin biçimde daha dar başlangıç ve bitiş tarihleri verir. Yanıtta sekiz nesne bulunur. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` ve `sade_sati_shani` nesnelerinin her biri `{status, end_date}` biçimindedir: evrenin transit anında sürüp sürmediğini gösteren bir boolean ile, sürüyorsa ISO 8601 UTC bitiş tarihi, sürmüyorsa null. `next_ashtama_shani`, `next_kantaka_shani` ve `next_dhaiya_shani` `{date, ref_house_from_natal}` biçimindedir; bir sonraki evrenin ne zaman başlayacağını ve referans noktasından sayılan hangi evin onu tetiklediğini verir. `next_sade_sati_shani` ise yalnızca `{date}` verir. İleriye doğru arama, transit anından itibaren yüz yılı kapsar. Kantaka ve Dhaiya'nın ikisi de dördüncü evi kapsadığı için çoğu zaman aynı tarihleri bildirir. Bu beklenen bir durumdur, yinelenen kayıt değildir.

https://api.occultapi.com/api/astro/shani_analysis/

İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

İstek alanları

Alan	Tür	Zorunlu	Notlar
chart_name_natal	string	zorunlu
chart_name_transit	string	zorunlu
date_time_natal	string (date-time)	zorunlu
date_time_transit	string (date-time)	zorunlu
latitude_natal	number (double)	zorunlu	min -180 · max 180
latitude_transit	number (double)	zorunlu	min -180 · max 180
longitude_natal	number (double)	zorunlu	min -180 · max 180
longitude_transit	number (double)	zorunlu	min -180 · max 180
mode	integer	zorunlu
ref_celestial	string	zorunlu	`ascendantmoon`

Örnek istek

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}'

Yanıt

{
  "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
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.