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

भावों के कारकत्व

कुंडली का हर भाव — यानी बारहों भाव — जीवन के कई विषयों का स्वामी है: चौथा घर और माता का, सातवाँ साझेदारी का, दसवाँ करियर का। यह एंडपॉइंट इनमें से किसी एक भाव की पूरी जानकारी लौटाता है: वह किसका प्रतीक है, उसका तत्व और स्वभाव, शीर्षकों में बँटे उसके विषय, और भावेश, उसमें बैठे ग्रहों और उसके नैसर्गिक कारकों से उसे कैसे परखें। यह लुकअप है, गणना नहीं। आप 1 से 12 तक का house_number भेजें, और हर बार वही पाठ मिलेगा — इसमें जन्म की तारीख़, समय या स्थान नहीं लगता। कहीं और बनाई गई कुंडली पर लेबल लगाने, या उसके साथ व्याख्या वाला पैनल भरने के लिए इसे इस्तेमाल करें। इसमें एक ही key है: get_house_info। 1-12 से बाहर की संख्या पर त्रुटि स्टेटस नहीं आता; HTTP 200 के साथ स्ट्रिंग 'Invalid house number' मिलती है।

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

ऑथेंटिकेशन

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

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

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

फ़ील्डटाइपज़रूरीटिप्पणी
house_numberintegerज़रूरी
123456789101112
keysarrayज़रूरी

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

get_house_info

स्ट्रिंग का ऐरे; इसमें केवल एक key है। ध्यान दें: कॉन्फ़िग फ़ाइल का नाम 'house_informations' (बहुवचन) है, जबकि रूट /api/astro/house_information/ है।

उपलब्ध keys (1)

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

Keyऔर कौन-से फ़ील्ड चाहिएविवरण
get_house_infohouse_numberकिसी एक भाव के सारे कारकत्व, house_number 1-12 से चुने गए। एक ऑब्जेक्ट लौटाती है, जिसमें ये होते हैं: 'other names' (भाव का संस्कृत नाम, जैसे Sukha Bhava), 'element & quality', पाठ के रूप में 'description', 'keywords & significations' — विषयों के हिसाब से बने समूहों का dictionary, हर समूह वाक्यांशों की सूची — और 'astrological info', यानी चार टिप्पणियाँ: भावेश, वहाँ बैठे ग्रह, नैसर्गिक कारक और भाव को परखने का एक सामान्य नियम। स्टैटिक संदर्भ पाठ, हर अनुरोध पर एक जैसा।

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

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

उत्तर

{
  "data": {
    "get_house_info": {
      "other names": "Sukha Bhava",
      "element & quality": "Movable, Water",
      "description": "The 4th house represents comfort, emotional happiness, and inner peace. It is deeply tied to one's home, mother, vehicles, land, and personal well-being. It is also connected to learning, cultural roots, and sacred knowledge. As the house of shelter, nurturing, and support, it governs the environments that provide safety and emotional grounding.",
      "keywords & significations": {
        "Comfort & Happiness": [
          "emotional peace",
          "joy",
          "contentment",
          "domestic bliss",
          "the source of one's sense of well-being"
        ],
        "Mother & Maternal Side": [
          "mother",
          "maternal relatives",
          "relationship with maternal lineage"
        ],
        "Home & Property": [
          "house",
          "real estate",
          "property matters",
          "living space",
          "entering a new home",
          "ancestral property",
          "loss of residence"
        ],
        "Conveyance & Travel": [
          "vehicles (rickshaws, boats, etc.)",
          "means of transportation",
          "local travel"
        ],
        "Land & Agriculture": [
          "land",
          "agriculture",
          "fertile fields",
          "gardens",
          "ponds and wells (including construction)",
          "land arising from islands or wet zones",
          "grain from wetlands"
        ],
        "Learning & Intellect": [
          "learning",
          "sacred texts",
          "wise counsel",
          "pure intellect"
        ],
        "Physical Comforts": [
          "perfumes",
          "clothing",
          "ornaments",
          "oil baths",
          "water and drinks",
          "celestial foods"
        ],
        "Cultural & Spiritual Values": [
          "castes",
          "rites",
          "religion-based education",
          "victory in personal efforts",
          "divine remedies"
        ],
        "Family & Relations": [
          "relatives",
          "well-wishers",
          "father",
          "wife",
          "friends",
          "children of siblings"
        ],
        "Security & Wealth": [
          "securing of savings",
          "stable financial base",
          "result or conclusion of efforts"
        ],
        "Animals & Livelihood": [
          "cattle (cows, buffaloes)",
          "horses",
          "elephants",
          "domestic animals for livelihood"
        ],
        "Creative & Domestic Arts": [
          "architecture",
          "art",
          "house-building skills",
          "pavilions",
          "layout and use of spaces"
        ],
        "Challenges": [
          "false accusations",
          "loss of home",
          "tiring or exhausting work"
        ],
        "Unique Aspects": [
          "trust",
          "noble reputation",
          "guidance in locating lost or hidden items",
          "anthills"
        ]
      },
      "astrological info": {
        "4th Lord (4L)": "Plays a pivotal role in determining sources of emotional comfort and security. Its placement, dignity, and the Bhava it occupies are key",
        "Planets in 4H": "Influence the nature of one's peace and comforts. When placed in their own, exalted, or friendly signs, they enhance well-being. If debilitated or afflicted by challenging combinations, the associated areas may become sources of discomfort",
        "Karaka Planets": "Moon – for mother and emotional nourishment; Venus – for conveyances, comforts, and pleasures; Mars – for land and property",
        "General Rule": "Strong, benefic influences on the 4th house and its lord lead to happiness, prosperity at home, and mental tranquility. Affliction or weakness indicates emotional disturbances or issues related to home and domestic life"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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