/api/astro/shani_analysis/1 क्रेडिटशनि गोचर के चरण
राशिचक्र में शनि की धीमी परिक्रमा से चार जाने-माने चरण बनते हैं, जिन पर भारतीय ज्योतिष ख़ास ध्यान देता है। सभी जन्म के चंद्रमा या जन्म लग्न से गिने जाते हैं: साढ़े साती, यानी उस बिंदु पर से शनि के गुज़रने के आसपास के साढ़े सात वर्ष; अष्टम शनि, यानी उससे आठवें भाव में शनि; कंटक शनि, यानी चौथे, सातवें या दसवें में शनि; और ढैय्या, जिसे अर्धाष्टम भी कहते हैं, यानी चौथे या आठवें में शनि। यह एंडपॉइंट बताता है कि किसी क्षण पर इनमें से कौन-सा चरण चल रहा है, वह कब ख़त्म होगा, और अगला कब शुरू होगा। दो कुंडलियों का विवरण भेजें: जन्म का विवरण `date_time_natal`, `latitude_natal`, `longitude_natal` और `chart_name_natal` में, और जिस क्षण के बारे में पूछना है, उसका विवरण इन्हीं के `_transit` वाले फ़ील्ड में। `ref_celestial` से चुनें कि चरण जन्म के चंद्रमा से गिने जाएँ या जन्म लग्न से। `mode` तय करता है कि जाँच कितनी सख़्त हो — 0 पर संपूर्ण राशि के हिसाब से भाव देखा जाता है, और ऊँचे मानों पर उसकी जगह संदर्भ बिंदु के आसपास अंशों की एक सीमा देखी जाती है, जिससे आरंभ और अंत की तारीख़ें काफ़ी सटीक आती हैं। उत्तर में आठ ऑब्जेक्ट होते हैं। `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` और `sade_sati_shani` में से हर एक `{status, end_date}` है: गोचर के क्षण पर चरण चल रहा है या नहीं, यह बूलियन में, और चल रहा हो तो ISO 8601 UTC में अंत की तारीख़, वरना null। `next_ashtama_shani`, `next_kantaka_shani` और `next_dhaiya_shani` `{date, ref_house_from_natal}` हैं: अगला चरण कब शुरू होगा, और संदर्भ बिंदु से कौन-सा भाव उसे शुरू करता है; `next_sade_sati_shani` में केवल `{date}` है। आगे की खोज गोचर के क्षण से सौ वर्ष तक चलती है। कंटक और ढैय्या, दोनों में चौथा भाव शामिल है, इसलिए दोनों में अक्सर एक जैसी तारीख़ें आती हैं। यह अपेक्षित है, दोहराव नहीं।
https://api.occultapi.com/api/astro/shani_analysis/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| chart_name_natal | string | ज़रूरी | |
| chart_name_transit | string | ज़रूरी | |
| date_time_natal | string (date-time) | ज़रूरी | |
| date_time_transit | string (date-time) | ज़रूरी | |
| latitude_natal | number (double) | ज़रूरी | min -180 · max 180 |
| latitude_transit | number (double) | ज़रूरी | min -180 · max 180 |
| longitude_natal | number (double) | ज़रूरी | min -180 · max 180 |
| longitude_transit | number (double) | ज़रूरी | min -180 · max 180 |
| mode | integer | ज़रूरी | |
| ref_celestial | string | ज़रूरी | ascendantmoon |
उदाहरण अनुरोध
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}'उत्तर
{
"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
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।