curl -X POST https://api.occultapi.com/api/astro/dasha_applicability/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["applicability_check"],"date_time":"2025-03-27T09:52:50.441Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year_option":365.256364,"start_option":"current","direction_option":"forward"}'वैदिक ज्योतिष में दशा की कई पद्धतियाँ हैं, और विंशोत्तरी के अलावा ज़्यादातर नक्षत्र दशाएँ सशर्त हैं: शास्त्रीय ग्रंथ कहते हैं कि अष्टोत्तरी तभी देखें जब कुंडली में कोई ख़ास शर्त पूरी हो, द्वादशोत्तरी तभी जब कोई दूसरी शर्त पूरी हो, और इसी तरह आगे। गलत पद्धति चुनी, तो किसी के पूरे जीवन के लिए गलत टाइमलाइन चल जाएगी। यह एंडपॉइंट ये शर्तें आपके लिए जाँचता है। यह जन्म विवरण से राशि, नवांश और द्वादशांश कुंडलियाँ बनाता है और छह सशर्त पद्धतियों — अष्टोत्तरी, चतुरशीति सम, द्वादशोत्तरी, द्विसप्तति, पंचोत्तरी और शताब्दिका — में से हर एक को उसी कुंडली पर परखता है, जिससे शास्त्रों में उसका निर्णय होता है। जन्म का क्षण और स्थान भेजें, साथ में `year_option` (वर्ष की लंबाई, दिनों में), `start_option` और `direction_option`; ये वही अवधि वाली सेटिंग्स हैं जो दशा एंडपॉइंट लेते हैं। नतीजे से तय करें कि आगे कौन-सा दशा एंडपॉइंट कॉल करना है।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| date_time | string (date-time) | ज़रूरी | जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। फ़ॉर्मैट की शर्त। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)। |
| direction_option | string | ज़रूरी | forwardbackwardकेस-संवेदी, छोटे अक्षरों में। कुछ और भेजने पर 400 "Invalid direction: must be 'forward' or 'backward'" मिलता है। |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। applicability_checkस्ट्रिंग का ऐरे; इसमें केवल एक key है। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| start_option | string | ज़रूरी | currentnextpreviousकेस-संवेदी, छोटे अक्षरों में। कुछ और भेजने पर 400 "Invalid start value: must be 'current', 'next', or 'previous'" मिलता है। अधिकतम लंबाई 100। |
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
| year_option | number (double) | ज़रूरी | 365.256364365.24219365.25365360min 360 · max 365.256364 |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| applicability_check | — | वे सशर्त नक्षत्र दशा पद्धतियाँ, जिनकी शास्त्रीय शर्तें यह कुंडली पूरी करती है। ये दिखने वाले नामों की सूची के रूप में आती हैं: "Ashtottari Dasha", "Chaturaseeti Sama Dasha", "Dwadashottari Dasha", "Dwisaptati Dasha", "Panchottari Dasha" और "Sataabdika Dasha" में से। खाली सूची का मतलब है कि छह में से कोई भी लागू नहीं होती। विंशोत्तरी बिना शर्त है, इसलिए यह इनमें नहीं आती। |