प्लेग्राउंड लोड हो रहा है
curl -X POST https://api.occultapi.com/api/astro/house/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["set_house_method"],"latitude":26.9124,"longitude":26.1046,"timezone_as_float":5.5,"method_name":"equal","notation":"astrological","date_time":"2024-11-18"}'किसी क्षण और स्थान के लिए बारह भावों का विभाजन, आप जो भी भाव पद्धति बताएँ, उसमें। वैदिक परंपरा में आम तौर पर पूरी राशि को ही भाव माना जाता है, पर यह एंडपॉइंट एफ़ेमेरिस की सारी पद्धतियाँ देता है — दो दर्जन पद्धतियों में Placidus, Koch, Campanus, Regiomontanus, Sripati, Porphyry, समान भाव और संपूर्ण राशि भी हैं — ताकि आप वही कुंडली उस पद्धति में बना सकें जो किसी परंपरा में चलती है। स्थितियाँ निरयन हैं। यहाँ कस्प और सीमा का फ़र्क समझना ज़रूरी है। कस्प वह एक अंश है जो पद्धति किसी भाव को देती है; सीमा वह पूरा फैलाव है जो भाव असल में घेरता है। यहाँ सीमा पास-पास के कस्पों के मध्य बिंदुओं से निकाली जाती है, यानी भाव पिछले कस्प की ओर आधी दूरी से शुरू होकर अगले कस्प की ओर आधी दूरी तक चलता है। `house_cusps` बारह कस्प देता है, `house_starts` और `house_ends` दोनों किनारे अलग-अलग, `house_ranges` दोनों किनारे एक साथ, और `houses` तीनों एक साथ। `notation` पूरे उत्तर की इकाइयाँ तय करता है: क्रांतिवृत्त पर कच्चे दशमलव अंशों के लिए 'degree', और राशि के साथ अंश, कला, विकला के लिए 'astrological'। `method_name` केस-संवेदी है, और कई वैल्यू में स्पेस या विराम चिह्न हैं, इसलिए इन्हें हूबहू कॉपी करें। अनुरोध बनते समय ही `method_name` से पद्धति लागू हो जाती है, इसलिए `set_house_method` और `change_house_system` तभी काम आती हैं, जब कई keys वाली कॉल के बीच में पद्धति बदलनी हो।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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 माना जाता है)। |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। set_house_methodhouseshouse_rangeshouse_startshouse_cuspshouse_endschange_house_systemस्ट्रिंग का ऐरे। 'set_house_method' और 'change_house_system' `method_name` लेती हैं; बाकी पाँच `notation` लेती हैं। |
| method_name | string | ज़रूरी | equalalcabitiuscampanusequal (mc)carter poli-equ.gauquelin sectorshorizon/azimutsunshinesavard-akochpullen sdmorinusकेस-संवेदी और छोटे अक्षरों में। कई वैल्यू में स्पेस, स्लैश या विराम चिह्न हैं - इन्हें हूबहू कॉपी करें, जैसे 'equal (mc)', 'carter poli-equ.', 'horizon/azimut'। |
| notation | string | ज़रूरी | astrologicaldegreeकेस-संवेदी, छोटे अक्षरों में। 'degree' पर कच्चे दशमलव अंश मिलते हैं; 'astrological' पर राशि + अंश/कला/विकला। कुछ और भेजने पर 400 मिलता है। |
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
| latitude | number (double) | वैकल्पिक | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9 |
| longitude | number (double) | वैकल्पिक | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| change_house_system | method_name | `set_house_method` वाला ही काम: `method_name` में दी गई पद्धति लागू करती है और null लौटाती है। दोनों keys एक ही कोड चलाती हैं, और इनमें कोई फ़र्क नहीं है। | |
| house_cusps | notation | चुनी गई भाव पद्धति के बारह भाव कस्प, भाव के क्रम में फ़्लैट सूची के रूप में। ये कस्प के अंश ही हैं, भावों की सीमाएँ नहीं — सीमाएँ `house_starts` और `house_ends` में हैं, और दो लगातार कस्पों के ठीक बीच में होती हैं। | |
| house_ends | notation | केवल हर भाव का आख़िरी किनारा, भाव के क्रम में बारह वैल्यू की फ़्लैट सूची के रूप में। हर किनारा उस भाव के कस्प और अगले कस्प का मध्य बिंदु है, इसलिए भाव n का अंत भाव n+1 का आरंभ भी होता है। | |
| house_ranges | notation | हर भाव का फैलाव, एक ऑब्जेक्ट के रूप में, जिसकी keys '1' से '12' हैं और हर एक में `start` और `end` है। किनारे पास-पास के कस्पों के मध्य बिंदु हैं, इसलिए भाव पिछले कस्प की ओर आधी दूरी से शुरू होकर अगले कस्प की ओर आधी दूरी पर ख़त्म होता है। 'degree' नोटेशन में वैल्यू दशमलव अंश होती हैं; 'astrological' में राशि, अंश, कला और विकला वाले ऑब्जेक्ट। | |
| house_starts | notation | केवल हर भाव का शुरुआती किनारा, भाव के क्रम में बारह वैल्यू की फ़्लैट सूची के रूप में — `house_ranges` की तरह भाव संख्या वाली keys का ऑब्जेक्ट नहीं। 'degree' नोटेशन में दशमलव अंश, और 'astrological' में राशि व अंश/कला/विकला वाले ऑब्जेक्ट। | |
| houses | notation | बारह भाव, जिनकी keys `1` से `12` हैं, और हर एक `{start, cusp, end}` है - दोनों सीमाएँ और उनके बीच का कस्प। ध्यान दें कि यह ढाँचा /api/astro/krishnamurti/ की `houses` key से अलग है, जो `{start, mid, end}` लौटाती है और जिसमें कस्प नहीं होता। `notation` इकाइयाँ तय करता है: `degree` पर दशमलव संख्याएँ मिलती हैं, `astrological` पर `"Aries 12 30 15"` जैसी स्ट्रिंग। | |
| set_house_method | method_name | `method_name` में दी गई भाव पद्धति से कस्पों की गणना फिर से करती है। यह स्विच है, वैल्यू नहीं — null लौटाती है, और ऐरे में केवल अपने बाद लिखी keys पर असर डालती है। अनुरोध बनते समय ही `method_name` से पद्धति लागू हो जाती है, इसलिए जब तक कॉल के बीच में पद्धति न बदलनी हो, इसकी ज़रूरत नहीं। |