शनि गोचर के चरण

राशिचक्र में शनि की धीमी परिक्रमा से चार जाने-माने चरण बनते हैं, जिन पर भारतीय ज्योतिष ख़ास ध्यान देता है। सभी जन्म के चंद्रमा या जन्म लग्न से गिने जाते हैं: साढ़े साती, यानी उस बिंदु पर से शनि के गुज़रने के आसपास के साढ़े सात वर्ष; अष्टम शनि, यानी उससे आठवें भाव में शनि; कंटक शनि, यानी चौथे, सातवें या दसवें में शनि; और ढैय्या, जिसे अर्धाष्टम भी कहते हैं, यानी चौथे या आठवें में शनि। यह एंडपॉइंट बताता है कि किसी क्षण पर इनमें से कौन-सा चरण चल रहा है, वह कब ख़त्म होगा, और अगला कब शुरू होगा। दो कुंडलियों का विवरण भेजें: जन्म का विवरण `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}` है। आगे की खोज गोचर के क्षण से सौ वर्ष तक चलती है। कंटक और ढैय्या, दोनों में चौथा भाव शामिल है, इसलिए दोनों में अक्सर एक जैसी तारीख़ें आती हैं। यह अपेक्षित है, दोहराव नहीं।

इस एंडपॉइंट का पूरा संदर्भ