प्लेग्राउंड लोड हो रहा है
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"}'किसी एक ग्रह की किसी एक स्थिति के लिए पहले से लिखे फलादेश। ग्रह बताएँ और यह बताएँ कि वह कहाँ बैठा है — किसी राशि में, किसी भाव में या किसी नक्षत्र में — और यह उस संयोग का शास्त्रीय फलादेश लौटाता है। यह किसी पाठ-संग्रह में खोज है, गणना नहीं: इसमें तारीख़, समय या स्थान की कोई भूमिका नहीं, और एक ही अनुरोध पर हमेशा वही पाठ मिलता है। जो कुंडली आप पहले ही निकाल चुके हैं, उस पर विवरण लिखने के लिए इसका इस्तेमाल करें। बृहस्पति की राशि, भाव और नक्षत्र `/api/astro/chart/` से लें, फिर पाठ के लिए यह एंडपॉइंट कॉल करें। तीनों keys एक ही कॉल में माँगी जा सकती हैं, पर हर key का अपना अतिरिक्त पैरामीटर है, इसलिए तीनों माँगने पर बॉडी में `planet`, `sign`, `house` और `nakshatra`, चारों होने चाहिए। नौ ग्रह (सात शास्त्रीय ग्रह और राहु-केतु), बारह राशियों और बारह भावों के लिए फलादेश हैं। नक्षत्र फलादेश केवल सात शास्त्रीय ग्रहों के लिए हैं — राहु और केतु के लिए कोई नहीं। अनजान ग्रह, राशि, भाव या नक्षत्र पर त्रुटि नहीं, बल्कि HTTP 200 के साथ एक व्याख्या वाली स्ट्रिंग मिलती है, इसलिए दिखाने से पहले जाँच लें कि आपको किस प्रकार की वैल्यू मिली है।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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 में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 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` फ़ील्ड के नाम में स्पेस है। |