सीधे सामग्री पर जाएँ
Occult API
POST/api/astro/house_lord_particular_house/1 क्रेडिट

भावेश की स्थिति (एक जोड़ी)

किसी भाव का स्वामी जहाँ भी जाता है, उस भाव के विषय अपने साथ ले जाता है, इसलिए शास्त्रों में 144 संयोजनों में से हर एक का अलग फल लिखा है — बारह स्वामी, बारह जगहों पर। यह एंडपॉइंट किसी एक जोड़ी का फल लौटाता है। जिस भाव के स्वामी की बात है, उसका नाम house में दें, इस एंडपॉइंट के संस्कृत भाव नामों में — पहले से बारहवें तक lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya — और वह जिस भाव में बैठा है, उसे number में 1 से 12 तक की संख्या के रूप में दें। ध्यान दें कि /api/astro/effect_house_lord_different_house/ भी यही काम करता है, पर उसके नाम और पाठ अलग हैं; दोनों को एक-दूसरे की जगह इस्तेमाल नहीं किया जा सकता। कुंडली से कोई गणना नहीं होती, इसलिए तारीख़, समय या स्थान नहीं भेजा जाता — स्वामी की स्थिति पहले ख़ुद निकाल लें। अनजान भाव नाम या सीमा से बाहर की संख्या पर त्रुटि स्टेटस नहीं आता; HTTP 200 के साथ स्ट्रिंग 'Invalid key: …' मिलती है। इसमें एक ही key है: get_house_lord।

https://api.occultapi.com/api/astro/house_lord_particular_house/
अनुरोध आज़माएँ

ऑथेंटिकेशन

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

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

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

फ़ील्डटाइपज़रूरीटिप्पणी
housestringज़रूरी
lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya

वह भाव, जिसके स्वामी (LORD) की स्थिति देखनी है: lagna = 1ला... vyaya = 12वाँ। चेतावनी: यह एंडपॉइंट /api/astro/effect_house_lord_different_house/ से अलग नाम इस्तेमाल करता है - यहाँ 5वें/6ठे/7वें/8वें/9वें भाव के नाम 'putra', 'satru', 'yuvati', 'randhara' (ध्यान दें, एक 'a' ज़्यादा है: randhAra) और 'dharma' हैं। वैल्यू छोटे अक्षरों में बदल दी जाती है। अनजान वैल्यू पर 200 के साथ "Invalid key: <x>" मिलता है।

keysarrayज़रूरी

कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।

get_house_lord

स्ट्रिंग का ऐरे; इसमें केवल एक key है।

numberintegerज़रूरी
123456789101112

1-12 का पूर्णांक - वह भाव, जिसमें स्वामी बैठा है। सीमा से बाहर होने पर 200 के साथ "Invalid key: <n>" मिलता है।

उपलब्ध keys (1)

आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।

Keyऔर कौन-से फ़ील्ड चाहिएविवरण
get_house_lordhouse, numberएक भाव के स्वामी के दूसरे भाव में बैठने के शास्त्रीय फल: house बताता है कि वह किस भाव का स्वामी है, और number बताता है कि वह किस भाव में बैठा है। अंग्रेज़ी के छोटे वाक्यों की सूची लौटाती है, आम तौर पर एक से तीन, जैसे 'Blessed with paternal and maternal happiness'। हर जोड़ी का तय संदर्भ पाठ; कुंडली से कुछ नहीं निकाला जाता।

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

curl -X POST https://api.occultapi.com/api/astro/house_lord_particular_house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_house_lord"],"house":"lagna","number":4}'

उत्तर

{
  "data": {
    "get_house_lord": [
      "Blessed with paternal and maternal happiness",
      "Gains many brothers, is charming, virtuous, and has a passionate nature"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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