curl -X POST https://api.occultapi.com/api/astro/dosha/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'दोष जन्म कुंडली का कोई ख़ास कष्टकारी योग है — ग्रहों की ऐसी नामित स्थिति, जिसे शास्त्रीय ग्रंथ नुक़सानदेह मानते हैं, ज़्यादातर विवाह, स्वास्थ्य या वंश के लिए। यह एंडपॉइंट जन्म के क्षण और स्थान से ऐसे आठ दोषों की जाँच करता है, और चाहें तो केवल नतीजे लौटाता है, चाहें तो सीधे दिखाने लायक लिखी हुई व्याख्याएँ। इसे दो तरह से इस्तेमाल किया जा सकता है। अलग-अलग keys (`kala_sarpa`, `manglik`, `pitru_dosha` आदि) संरचित नतीजे लौटाती हैं, जिन्हें कोड में सीधे इस्तेमाल किया जा सकता है। `get_dosha_details` पूरा सेट फ़ॉर्मैट किए हुए HTML पैराग्राफ़ों के रूप में लौटाती है, जिनकी keys दोषों के अंग्रेज़ी नाम हैं; रिपोर्ट दिखानी हो, तो यही चाहिए। इसमें काल सर्प, मांगलिक, पितृ, गुरु चांडाल, कलत्र, घात और श्रापित दोष हैं, पर गंड मूल नहीं। अपना पाठ ख़ुद तैयार करना चाहें, तो `get_dosha_resources` पूरा मूल पाठ-संग्रह देती है। serializer सभी बूलियन और संरचित अनुरोध फ़ील्ड को ज़रूरी मानता है, उन keys के लिए भी जो उन्हें इस्तेमाल नहीं करतीं। `manglik_reference_planet` ग्रह इंडेक्स है (0 सूर्य, 1 चंद्रमा, 2 मंगल, 3 बुध, 4 बृहस्पति, 5 शुक्र, 6 शनि, 7 राहु, 8 केतु); इंजन का अपना डिफ़ॉल्ट, यानी लग्न से मापना, API से नहीं चुना जा सकता, क्योंकि फ़ील्ड पूर्णांक प्रकार का है। इस एंडपॉइंट पर UTC ऑफ़सेट वाले फ़ील्ड का नाम `timezone` है, `timezone_as_float` नहीं।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| apply_exceptions | boolean | ज़रूरी | |
| 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 माना जाता है)। |
| include_2nd_house | boolean | ज़रूरी | |
| include_lagna_house | boolean | ज़रूरी | |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_detailsस्ट्रिंग का ऐरे। 'manglik' के लिए manglik_reference_planet, include_lagna_house, include_2nd_house और apply_exceptions ज़रूरी हैं; 'ganda_moola' के लिए moon_star; और 'get_dosha_details' के लिए date_time और geopos। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| manglik_reference_planet | integer | ज़रूरी | |
| moon_star | string | ज़रूरी | अर्थ के हिसाब से यह 1-27 के बीच की नक्षत्र संख्या है (गंड मूल नक्षत्र हैं: 1 अश्विनी, 9 आश्लेषा, 10 मघा, 18 ज्येष्ठा, 19 मूल, 27 रेवती)। जब तक प्रकार का यह बेमेल ठीक नहीं होता, तब तक स्वीकार होने वाली वैल्यू की कोई ऐसी सूची नहीं दी जा सकती जो सच में काम करे। |
| timezone | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30)। इसका अर्थ timezone_as_float जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं। |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| ganda_moola | moon_star | गंड मूल: जन्म नक्षत्र छह संधि नक्षत्रों (अश्विनी, आश्लेषा, मघा, ज्येष्ठा, मूल, रेवती) में से एक है या नहीं। इसे `moon_star` में 1–27 की नक्षत्र संख्या लेकर बूलियन लौटाना चाहिए, पर फ़ील्ड का प्रकार स्ट्रिंग है, जबकि तुलना वाली सूची में पूर्णांक हैं, इसलिए अभी यह key हर इनपुट पर false ही लौटाती है। | |
| get_dosha_details | date_time, geopos | व्याख्या वाले सातों दोष, एक साथ जाँचे और लिखे हुए: एक ऑब्जेक्ट, जिसकी keys दोषों के अंग्रेज़ी नाम हैं — Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha और Shrapit Dosha — और जिसकी वैल्यू HTML अंश हैं, जो बताते हैं कि दोष है या नहीं और उसका क्या अर्थ है। गंड मूल इसमें नहीं है। `date_time` और स्थान ज़रूरी हैं। | |
| get_dosha_resources | — | दोषों की व्याख्या का पूरा पाठ-संग्रह: एक ऑब्जेक्ट, जिसकी keys दोषों के नाम हैं ('kala_sarpa', 'manglik', 'pitru', 'ghata' आदि), और हर नाम के नीचे अंग्रेज़ी पैराग्राफ़ों की सूची। सूची का पहला पैराग्राफ़ 'no such dosha' वाला पाठ है, और बाकी पैराग्राफ़ संबंधित भाव या प्रकार के हिसाब से हैं। पहले से तैयार HTML के बजाय अपना पाठ ख़ुद बनाना हो, तो इसे इस्तेमाल करें। | |
| ghata | — | घात दोष: मंगल और शनि एक ही राशि में। एक बूलियन लौटाती है। | |
| guru_chandala_dosha | — | गुरु चांडाल: बृहस्पति की राहु या केतु के साथ एक ही राशि में युति। दो आइटम वाली सूची लौटाती है: [योग है या नहीं, दोनों में बृहस्पति ज़्यादा बलवान है या नहीं]। युति न हो, तो दोनों false होते हैं। | |
| kala_sarpa | — | काल सर्प दोष: true, जब सातों शास्त्रीय ग्रह राहु और केतु के बीच, पात-अक्ष के एक ही ओर घिरे हों। एक बूलियन लौटाती है; दोष का प्रकार (अनंत, कुलिक, वासुकि आदि) राहु के भाव से तय होता है। | |
| kalathra | — | कलत्र दोष, यानी विवाह भाव का कष्ट। true, जब हर नैसर्गिक पाप ग्रह — सूर्य, मंगल, शनि, राहु और केतु — सातवें भाव से गिनकर 1ले, 2रे, 4थे, 7वें, 8वें या 12वें भाव में हो। एक बूलियन लौटाती है, और इसके लिए पाँचों पाप ग्रहों का शर्त पूरी करना ज़रूरी है, इसलिए यह बहुत कम ही true होती है। | |
| manglik | manglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptions | मांगलिक, यानी मंगल दोष: `manglik_reference_planet` से गिनने पर मंगल विवाह को पीड़ित करने वाले भावों में से किसी में है या नहीं। तीन आइटम वाली सूची लौटाती है: [मांगलिक है या नहीं, कोई परिहार लागू होता है या नहीं, मेल खाने वाले परिहार नियमों की संख्याएँ]। जाँचे जाने वाले भाव 4था, 7वाँ, 8वाँ और 12वाँ हैं; `include_2nd_house` true हो, तो 2रा भी, और `include_lagna_house` true हो, तो 1ला भी। परिहार तभी जाँचे जाते हैं, जब `apply_exceptions` true हो। | |
| pitru_dosha | — | पितृ दोष, यानी वंश का कष्ट। दो आइटम वाली सूची लौटाती है: [true या false, जो नियम लागू हुए उनकी संख्याएँ]। पाँच नियम क्रम से जाँचे जाते हैं: 9वें भाव में सूर्य, चंद्रमा या राहु; 4थे भाव में केतु; मंगल या शनि से पीड़ित सूर्य/चंद्रमा/राहु/केतु; 2रे, 5वें, 9वें या 12वें भाव में बुध, शुक्र और राहु का जमावड़ा; और किसी पात के साथ सूर्य या चंद्रमा की युति। | |
| shrapit | — | श्रापित दोष: शनि और राहु एक ही राशि में। एक बूलियन लौटाती है। |