/api/astro/planet_insights/1 क्रेडिटग्रह स्थिति के फलादेश
किसी एक ग्रह की किसी एक स्थिति के लिए पहले से लिखे फलादेश। ग्रह बताएँ और यह बताएँ कि वह कहाँ बैठा है — किसी राशि में, किसी भाव में या किसी नक्षत्र में — और यह उस संयोग का शास्त्रीय फलादेश लौटाता है। यह किसी पाठ-संग्रह में खोज है, गणना नहीं: इसमें तारीख़, समय या स्थान की कोई भूमिका नहीं, और एक ही अनुरोध पर हमेशा वही पाठ मिलता है। जो कुंडली आप पहले ही निकाल चुके हैं, उस पर विवरण लिखने के लिए इसका इस्तेमाल करें। बृहस्पति की राशि, भाव और नक्षत्र `/api/astro/chart/` से लें, फिर पाठ के लिए यह एंडपॉइंट कॉल करें। तीनों keys एक ही कॉल में माँगी जा सकती हैं, पर हर key का अपना अतिरिक्त पैरामीटर है, इसलिए तीनों माँगने पर बॉडी में `planet`, `sign`, `house` और `nakshatra`, चारों होने चाहिए। नौ ग्रह (सात शास्त्रीय ग्रह और राहु-केतु), बारह राशियों और बारह भावों के लिए फलादेश हैं। नक्षत्र फलादेश केवल सात शास्त्रीय ग्रहों के लिए हैं — राहु और केतु के लिए कोई नहीं। अनजान ग्रह, राशि, भाव या नक्षत्र पर त्रुटि नहीं, बल्कि HTTP 200 के साथ एक व्याख्या वाली स्ट्रिंग मिलती है, इसलिए दिखाने से पहले जाँच लें कि आपको किस प्रकार की वैल्यू मिली है।
https://api.occultapi.com/api/astro/planet_insights/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| house | integer | ज़रूरी | |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| nakshatra | string | ज़रूरी | ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguniऊपर की सूची वही है जो jupiter, mercury, venus और saturn इस्तेमाल करते हैं। 'rahu' और 'ketu' के लिए कोई नक्षत्र डेटा है ही नहीं। मेल न खाने वाली वैल्यू पर HTTP 200 के साथ "Invalid nakshatra: <x> for planet <p>" मिलता है। |
| planet | string | ज़रूरी | sunmoonmarsmercuryjupitervenussaturnrahuketuअनजान ग्रह पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid planet: <x>" मिलती है। ध्यान दें कि rahu और ketu के लिए कोई नक्षत्र डेटा नहीं है (insights['rahu']['nakshatras'] का मान None है), इसलिए get_planet_nakshatra_insight "No nakshatra data available for rahu" लौटाती है। |
| sign | string | ज़रूरी | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesदर्ज करने लायक डेटा बग: planet='sun' के लिए key की वर्तनी 'virgo' के बजाय गलती से 'vigro' है, इसलिए sun+virgo पर "Invalid sign: virgo for planet sun" मिलता है जबकि sun+vigro काम करता है। बाकी आठों ग्रह 'virgo' इस्तेमाल करते हैं। |
उपलब्ध keys (3)
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण |
|---|---|---|
| get_planet_house_insight | planet, house | किसी भाव में बैठे `planet` का फलादेश, जहाँ `house` 1 से 12 है। एक ऑब्जेक्ट लौटाती है जिसमें भाव का लेबल, सारांश और गुणों की सूचियाँ होती हैं, साथ में `classicalTexts` — `{heading, text}` की सूची, जो उस स्थिति पर पराशर, बृहत् जातक, सारावली और फलदीपिका को उद्धृत करती है — और `houseLordVariations`, `{ascendent, aspect, result}` की सूची, जो बताती है कि बारह लग्नों में से हर एक के लिए फलादेश कैसे बदलता है। जहाँ केवल शास्त्रीय उद्धरण मौजूद हैं, वहाँ सारांश और गुणों वाले कुछ फ़ील्ड null होते हैं। |
| get_planet_nakshatra_insight | planet, nakshatra | `nakshatra` में बैठे `planet` का फलादेश, संरचित ऑब्जेक्ट के बजाय एक-दो वाक्यों के सादे पाठ के रूप में। सात शास्त्रीय ग्रहों के लिए सभी 27 नक्षत्रों में उपलब्ध; राहु और केतु के नक्षत्र फलादेश नहीं हैं और उनके लिए इसके बजाय एक व्याख्यात्मक स्ट्रिंग लौटाई जाती है। |
| get_planet_sign_insight | planet, sign | `sign` में बैठे `planet` का फलादेश। एक ऑब्जेक्ट लौटाती है जिसमें `sign` (संयोग का संस्कृत लेबल, जैसे "Mesa Brhaspati"), एक `summary` पैराग्राफ़, और सूचियाँ `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` और `drstiphala` होती हैं, जिनमें आखिरी वहाँ से उस ग्रह की दृष्टियों के प्रभाव बताती है। ध्यान दें कि `core traits` फ़ील्ड के नाम में स्पेस है। |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'उत्तर
{
"data": {
"get_planet_sign_insight": {
"sign": "Mesa Brhaspati",
"summary": "Jupiter in Aries produces a bold, authoritative, and resourceful individual with strong leadership capabilities. Aries is ruled by Mars (Maṅgala), a planet friendly to Jupiter and symbolizing courage, initiative, and battle-readiness. Jupiter here gains the spirit of a warrior-sage, combining spiritual strength with physical initiative. The placement enhances fame, wealth, power, and generational prosperity, especially through sons. However, the position also introduces difficulties like enemies, physical injuries, and excessive expenditures due to Aries being the debilitation sign for Saturn (Śani), whose tamasic qualities interfere with Jupiter's sattvic nature. The individual is splendorous, generous, and powerful, but also faces trials that temper their greatness",
"core traits": [
"Argumentative in disposition",
"Acquiring precious stones and ornaments through effort",
"Endowed with strength, sons, and wealth",
"Eminent and famous profession",
"Splendorous",
"Many enemies",
"Many expenses",
"Injured body",
"Confers severe and cruel punishments"
],
"psychologicalPhysicalTraits": [
"Argumentative in disposition",
"Acquiring precious stones and ornaments through effort",
"Endowed with strength, sons, and wealth",
"Eminent and famous profession",
"Splendorous",
"Many enemies",
"Many expenses",
"Injured body",
"Confers severe and cruel punishments",
"Love of grandeur",
"Powerful",
"Wealthy",
"Prudent",
"Many children",
"Courteous",
"Generous",
"Firm",
"Sympathetic",
"Happy marriage",
"Patient nature",
"Harmonious",
"Refined",
"High position"
],
"astrologicalReasoning": [
{
"heading": "Initiative & Argumentation",
"text": "Meṣa is ruled by Maṅgala, the god of war and action, endowing Jupiter with a strong fighting disposition and argumentative temperament."
},
{
"heading": "Wealth & Luxuries",
"text": "Sūrya, exalted in Meṣa, governs precious metals and gemstones. Jupiter, the Dhanakāraka, placed here results in acquiring valuables through effort."
},
{
"heading": "Progeny & Strength",
"text": "Meṣa is a masculine sign ruled by male planets (Sūrya and Maṅgala). Jupiter, as the Santana Kāraka, gains support here, indicating sons, strength, and vitality."
},
{
"heading": "Fame & Eminence",
"text": "As the 1st house of Kālapuruṣa, Aries governs fame. Jupiter's placement brings name, professional eminence, and public recognition."
},
{
"heading": "Drawbacks of the Sign",
"text": "Meṣa is Śani's debilitation sign. Jupiter here absorbs Śani's weaknesses, causing a rise in enemies (6H), injury-proneness, emotional detachment (due to 8H being Moon's debilitation), and heavy expenditure (12H effects)."
},
{
"heading": "Judgement & Harshness",
"text": "With Jupiter reflecting Maṅgala's and Śani's stern traits, the native may confer harsh or severe judgments lacking emotional nuance."
}
],
"drstiphala": [
{
"planet": "Sūrya",
"aspect": "positive",
"result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
},
{
"planet": "Candra",
"aspect": "positive",
"result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
},
{
"planet": "Maṅgala",
"aspect": "positive",
"result": "Belonging to a royal dynasty, fearless, fierce, endowed with political knowledge, modest, affluent, has a disobedient wife and disobedient servants."
},
{
"planet": "Budha",
"aspect": "negative",
"result": "Liar, crafty, sinful, skilful in detecting others' flaws, serves others, grateful, modest, not outspoken."
},
{
"planet": "Śukra",
"aspect": "positive",
"result": "Very happy with residences, sleeping comforts, robes, perfumes, garlands, ornaments, wife, very timid."
},
{
"planet": "Śani",
"aspect": "mixed",
"result": "Talkative, eloquent, devoid of happiness, brilliant, has mean children and a mean wife."
}
]
}
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं, हर नतीजा उसी नाम से जिससे आपने माँगा।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।