POST/api/astro/house/1 क्रेडिट

भाव कस्प

किसी क्षण और स्थान के लिए बारह भावों का विभाजन, आप जो भी भाव पद्धति बताएँ, उसमें। वैदिक परंपरा में आम तौर पर पूरी राशि को ही भाव माना जाता है, पर यह एंडपॉइंट एफ़ेमेरिस की सारी पद्धतियाँ देता है — दो दर्जन पद्धतियों में 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 वाली कॉल के बीच में पद्धति बदलनी हो।

https://api.occultapi.com/api/astro/house/

अनुरोध आज़माएँ

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
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 (7)

आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम 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` से पद्धति लागू हो जाती है, इसलिए जब तक कॉल के बीच में पद्धति न बदलनी हो, इसकी ज़रूरत नहीं।

उदाहरण अनुरोध

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"}'

उत्तर

{
  "data": {
    "set_house_method": null
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं, हर नतीजा उसी नाम से जिससे आपने माँगा।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।