curl -X POST https://api.occultapi.com/api/astro/panchang_element_birth_effect/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_vaara_during_birth"],"vaara":"sunday","hora":"surya","paksha":"shukla","tithi":"pratipada","karana":"bava","yoga":"vishkumbha"}'पंचांग के अंग — वार, तिथि, करण, योग और पक्ष, और साथ में होरा — इनमें से हर एक में जन्मे व्यक्ति के स्वभाव का एक शास्त्रीय फलादेश होता है। यह एंडपॉइंट उन्हीं फलादेशों की लुकअप तालिका है। यह केवल संदर्भ पाठ है: कोई गणना नहीं होती, और कोई तारीख़, समय या स्थान नहीं भेजा जाता। व्यक्ति की जन्म तिथि, वार आदि आप कहीं और से निकालें (जैसे /api/astro/panchanga/ से) और हर एक का पैराग्राफ़ पाने के लिए उनके नाम भेजें। छह लुकअप keys हैं: get_vaara_during_birth, get_birth_tithi_effects, get_birth_karana_effects, get_birth_panchang_yoga_effects, get_birth_paksha_effects और get_birth_hora_result; हर key उसी नाम वाला अनुरोध फ़ील्ड लेती है। हर स्वीकार्य वैल्यू छोटे अक्षरों में लिखा लिप्यंतरण है, और वर्तनी हूबहू होनी चाहिए — 'shula', 'shoola' नहीं; 'priti', 'preeti' नहीं — और होरा का नाम वार से नहीं, संस्कृत ग्रह नाम (surya, chandra, mangala…) से दिया जाता है। छह get_all_*_keys सहायक keys स्वीकार्य सूचियाँ लौटाती हैं, और get_all_keys_summary छहों सूचियाँ एक साथ; शब्दावली हार्ड-कोड करने के बजाय इन्हीं में से किसी का इस्तेमाल करें। अनजान वैल्यू पर त्रुटि नहीं मिलती: HTTP 200 के साथ एक स्ट्रिंग लौटती है, जिसमें मान्य विकल्पों की सूची होती है।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| hora | string | वैकल्पिक | suryachandramangalabudhabrihaspatishukrashaniअनजान वैल्यू पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid hora: <x>. Available options: [...]" मिलती है; यह एंडपॉइंट एक साथी key 'get_all_hora_keys' भी देता है जो रनटाइम पर ठीक यही सूची लौटाती है। लिप्यंतरण की शैली पर ध्यान दें: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (shoola/preeti/indra नहीं), और होरा की वैल्यू संस्कृत ग्रह नाम हैं (surya/chandra/mangala/budha/brihaspati/shukra/shani), वार या ग्रहों के अंग्रेज़ी नाम नहीं। |
| karana | string | वैकल्पिक | bavabalavakaulavataitilagaravanijavishtishakunichatushpadanagakimstughnaअनजान वैल्यू पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid karana: <x>. Available options: [...]" मिलती है; यह एंडपॉइंट एक साथी key 'get_all_karana_keys' भी देता है जो रनटाइम पर ठीक यही सूची लौटाती है। लिप्यंतरण की शैली पर ध्यान दें: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (shoola/preeti/indra नहीं), और होरा की वैल्यू संस्कृत ग्रह नाम हैं (surya/chandra/mangala/budha/brihaspati/shukra/shani), वार या ग्रहों के अंग्रेज़ी नाम नहीं। |
| paksha | string | वैकल्पिक | shuklakrishnaअनजान वैल्यू पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid paksha: <x>. Available options: [...]" मिलती है; यह एंडपॉइंट एक साथी key 'get_all_paksha_keys' भी देता है जो रनटाइम पर ठीक यही सूची लौटाती है। लिप्यंतरण की शैली पर ध्यान दें: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (shoola/preeti/indra नहीं), और होरा की वैल्यू संस्कृत ग्रह नाम हैं (surya/chandra/mangala/budha/brihaspati/shukra/shani), वार या ग्रहों के अंग्रेज़ी नाम नहीं। |
| tithi | string | वैकल्पिक | pratipadadvitiyatritiyachaturthipanchamishashthisaptamiashtaminavamidashamiekadashidvadashiअनजान वैल्यू पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid tithi: <x>. Available options: [...]" मिलती है; यह एंडपॉइंट एक साथी key 'get_all_tithi_keys' भी देता है जो रनटाइम पर ठीक यही सूची लौटाती है। लिप्यंतरण की शैली पर ध्यान दें: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (shoola/preeti/indra नहीं), और होरा की वैल्यू संस्कृत ग्रह नाम हैं (surya/chandra/mangala/budha/brihaspati/shukra/shani), वार या ग्रहों के अंग्रेज़ी नाम नहीं। |
| vaara | string | वैकल्पिक | sundaymondaytuesdaywednesdaythursdayfridaysaturdayअनजान वैल्यू पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid vaara: <x>. Available options: [...]" मिलती है; यह एंडपॉइंट एक साथी key 'get_all_vaara_keys' भी देता है जो रनटाइम पर ठीक यही सूची लौटाती है। लिप्यंतरण की शैली पर ध्यान दें: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (shoola/preeti/indra नहीं), और होरा की वैल्यू संस्कृत ग्रह नाम हैं (surya/chandra/mangala/budha/brihaspati/shukra/shani), वार या ग्रहों के अंग्रेज़ी नाम नहीं। |
| yoga | string | वैकल्पिक | vishkumbhapritiayushmansaubhagyashobhanaatigandasukarmadhritishulagandavriddhidhruvaअनजान वैल्यू पर त्रुटि स्टेटस के बजाय HTTP 200 के साथ स्ट्रिंग "Invalid yoga: <x>. Available options: [...]" मिलती है; यह एंडपॉइंट एक साथी key 'get_all_yoga_keys' भी देता है जो रनटाइम पर ठीक यही सूची लौटाती है। लिप्यंतरण की शैली पर ध्यान दें: 'shula'/'priti'/'siddha'/'siddhi'/'aindra' (shoola/preeti/indra नहीं), और होरा की वैल्यू संस्कृत ग्रह नाम हैं (surya/chandra/mangala/budha/brihaspati/shukra/shani), वार या ग्रहों के अंग्रेज़ी नाम नहीं। |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| get_all_hora_keys | — | सात होरा नाम, जिन्हें यह एंडपॉइंट स्वीकार करता है — छोटे अक्षरों में संस्कृत ग्रह नामों की सूची। | |
| get_all_karana_keys | — | ग्यारह करण नाम, जिन्हें यह एंडपॉइंट स्वीकार करता है — छोटे अक्षरों वाली स्ट्रिंग की सूची। | |
| get_all_keys_summary | — | सभी छह श्रेणियों की हर स्वीकार्य वैल्यू, एक ही ऑब्जेक्ट में, जिसकी keys vaara_keys, hora_keys, paksha_keys, tithi_keys, karana_keys और yoga_keys हैं। छह कॉल की जगह एक कॉल। | |
| get_all_paksha_keys | — | दो पक्ष नाम, जिन्हें यह एंडपॉइंट स्वीकार करता है — छोटे अक्षरों वाली स्ट्रिंग की सूची: shukla और krishna। | |
| get_all_tithi_keys | — | सोलह तिथि नाम, जिन्हें यह एंडपॉइंट स्वीकार करता है — छोटे अक्षरों वाली स्ट्रिंग की सूची। वर्तनियाँ हार्ड-कोड करने के बजाय पिकर में विकल्प भरने के लिए इसे इस्तेमाल करें। | |
| get_all_vaara_keys | — | सात वार नाम, जिन्हें यह एंडपॉइंट स्वीकार करता है — छोटे अक्षरों में दिनों के अंग्रेज़ी नामों की सूची। | |
| get_all_yoga_keys | — | सत्ताईस नित्य योग नाम, जिन्हें यह एंडपॉइंट स्वीकार करता है — छोटे अक्षरों वाली स्ट्रिंग की सूची। | |
| get_birth_hora_result | hora | जन्म के क्षण पर चल रही होरा का फलादेश। hora छोटे अक्षरों में संस्कृत ग्रह नाम के रूप में लेती है — surya, chandra, mangala, budha, brihaspati, shukra, shani — और अंग्रेज़ी का एक छोटा पैराग्राफ़ लौटाती है। | |
| get_birth_karana_effects | karana | जन्म करण का फलादेश। karana छोटे अक्षरों वाले ग्यारह नामों (bava, balava, kaulava, taitila, gara, vanija, vishti, shakuni, chatushpada, naga, kimstughna) में से एक के रूप में लेती है और अंग्रेज़ी का एक पैराग्राफ़ लौटाती है। | |
| get_birth_paksha_effects | paksha | शुक्ल या कृष्ण पक्ष में जन्म का फलादेश। paksha के रूप में 'shukla' या 'krishna' लेती है और अंग्रेज़ी का एक पैराग्राफ़ लौटाती है। | |
| get_birth_panchang_yoga_effects | yoga | जन्म के समय चल रहे नित्य योग का फलादेश। yoga छोटे अक्षरों वाले सत्ताईस नामों में से एक के रूप में लेती है — vishkumbha से vaidhriti तक — और अंग्रेज़ी का एक पैराग्राफ़ लौटाती है। | |
| get_birth_tithi_effects | tithi | जन्म तिथि का फलादेश। tithi छोटे अक्षरों वाले सोलह नामों में से एक के रूप में लेती है — pratipada से chaturdashi तक, और साथ में purnima और amavasya — और अंग्रेज़ी का एक पैराग्राफ़ लौटाती है। एक ही नाम दोनों पक्षों की उस तिथि के लिए चलता है। | |
| get_vaara_during_birth | vaara | किसी वार को जन्म लेने वाले व्यक्ति के स्वभाव का फलादेश। vaara छोटे अक्षरों में दिन के अंग्रेज़ी नाम के रूप में लेती है और अंग्रेज़ी का एक पैराग्राफ़ लौटाती है। अनजान वैल्यू पर मान्य विकल्पों की सूची वाली स्ट्रिंग मिलती है, और स्टेटस फिर भी HTTP 200 रहता है। |