/api/astro/ashtakoota/1 क्रेडिटअष्टकूट (गुण मिलान)
अष्टकूट उत्तर भारत की आठ हिस्सों वाली पद्धति है, जिसमें वर-वधू का मिलान केवल उनके जन्म नक्षत्रों से होता है। आठ गुणों में से हर एक को अंक मिलते हैं — वर्ण 1 में से, वश्य 2 में से, तारा 3 में से, योनि 4 में से, ग्रह मैत्री 5 में से, गण 6 में से, भकूट 7 में से और नाड़ी 8 में से — कुल अधिकतम 36 अंक। दक्षिण भारत की पद्धति ('porutham') भी लगभग यही सवाल पूछती है, पर ज़्यादातर का जवाब हाँ या ना में देती है, और चार परीक्षण और जोड़ती है: माहेंद्र, वेध, रज्जु और स्त्री दीर्घ। आपको केवल चार संख्याएँ देनी हैं: वधू और वर का नक्षत्र (1–27, अश्विनी से रेवती तक) और हर एक का पद (1–4)। जन्म समय या स्थान की ज़रूरत नहीं — अगर आपके पास नक्षत्र के बजाय यही जानकारी है, तो /api/astro/horoscope-match/ इस्तेमाल करें, जो नक्षत्र ख़ुद निकालता है और ज़्यादा विस्तृत रिपोर्ट देता है। शुरुआत `compatibility_score` key से करें: यह सारे परीक्षण चलाती है और कुल अंकों के साथ उनके नतीजे लौटाती है। दो बातें जान लें। `method` फ़ील्ड स्वीकार तो होता है, पर गणना तक कभी नहीं पहुँचता, इसलिए हमेशा उत्तर भारतीय गुणांकन ही लगता है; किसी परीक्षण का दक्षिण भारतीय हाँ/ना वाला रूप चाहिए, तो उसकी अलग `_south` key माँगें। और उत्तर भारतीय रूप के अंक वाले कूट सिर्फ़ एक संख्या नहीं, बल्कि दो आइटम वाली सूची [अंक, अधिकतम] लौटाते हैं।
https://api.occultapi.com/api/astro/ashtakoota/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| boy_nakshatra_number | integer | ज़रूरी | |
| boy_paadham_number | integer | ज़रूरी | |
| girl_nakshatra_number | integer | ज़रूरी | |
| girl_paadham_number | integer | ज़रूरी | |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। raasi_from_nakshatra_padavarna_poruthamvasiya_poruthamvasiya_porutham_southdina_poruthamdina_porutham_southgana_poruthamgana_porutham_southyoni_poruthamyoni_porutham_southraasi_adhipathi_poruthamraasi_adhipathi_porutham_southस्ट्रिंग का ऐरे। `_south` वाली keys उसी पोरुथम का दक्षिण भारतीय बूलियन रूप लौटाती हैं। |
| method | string | ज़रूरी | NorthSouthमहत्वपूर्ण: `method` को ज़रूरी तो घोषित किया गया है, पर इसे इंजन तक कभी भेजा नहीं जाता, इसलिए आप कुछ भी भेजें, अष्टकूट का डिफ़ॉल्ट "North" ही इस्तेमाल होता है। अगर यह भेजा जाता, तो इंजन 'south' को केस-असंवेदी आंशिक मिलान से खोजता, यानी 'South'/'south'/'South Indian' से दक्षिण भारतीय तरीका चुना जाता और बाकी किसी भी वैल्यू से उत्तर भारतीय। |
| nakshatra_number | integer | ज़रूरी | |
| paadha_number | integer | ज़रूरी | |
| use_astroyogi_method | boolean | ज़रूरी |
उपलब्ध keys (25)
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण |
|---|---|---|
| compatibility_score | — | सारे परीक्षण एक साथ, 13 प्रविष्टियों की फ़्लैट सूची में, इस क्रम में: वर्ण, वश्य, गण, दिन, योनि, ग्रह मैत्री, भकूट और नाड़ी सीधी संख्याओं के रूप में, फिर 36 में से कुल अंक, फिर माहेंद्र, वेध, रज्जु और स्त्री दीर्घ बूलियन के रूप में। ध्यान दें कि यहाँ पहले आठ सीधे अंक हैं, अलग-अलग keys वाले [अंक, अधिकतम] जोड़े नहीं, और यह क्रम 1 से 8 अंकों वाला क्रम भी नहीं है। |
| dina_porutham | — | दिन कूट, जिसे तारा कूट भी कहते हैं — वधू के नक्षत्र से वर के नक्षत्र तक गिनता है और इससे बनी तारा श्रेणी से स्वास्थ्य और कुशलता देखता है। इसके 3 अंक हैं; [अंक, 3.0] लौटाती है, जिसमें अंक 0.0, 1.5 या 3.0 होता है। |
| dina_porutham_south | — | दिन कूट का दक्षिण भारतीय रूप: true, जब वर से वधू तक नक्षत्रों की गिनती उन बारह गिनतियों (2, 4, 6, 8, 9, 11, 13, 15, 18, 20, 24, 26) में से एक हो जिन्हें शुभ माना जाता है। एक बूलियन लौटाती है। |
| gana_porutham | — | गण कूट, जो दोनों के स्वभाव — देव, मनुष्य या राक्षस — की तुलना करता है; इसके 6 अंक हैं। [अंक, 6] लौटाती है, जिसमें अंक 0, 1, 5 या 6 होता है। |
| gana_porutham_south | — | गण का दक्षिण भारतीय रूप: true केवल तब, जब दक्षिण भारतीय सूचियों के अनुसार दोनों नक्षत्र एक ही गण के हों। यह बूलियन लौटाती है, इसलिए जिस आंशिक मेल को उत्तर भारतीय रूप में 5 अंक मिलते, वह यहाँ false होता है। |
| mahendra_porutham | — | माहेंद्र, दक्षिण भारत के चार अतिरिक्त परीक्षणों में से एक, जो संतान और रिश्ते के टिकाऊपन से जुड़ा है। true, जब वधू के नक्षत्र से वर के नक्षत्र तक की गिनती 4, 7, 10, 13, 16, 19, 22 या 25 हो। एक बूलियन लौटाती है। |
| mahendra_porutham_south | — | `mahendra_porutham` जैसा ही — दक्षिण भारतीय रूप सीधे उसी को बुलाता है, इसलिए दोनों keys एक ही बूलियन लौटाती हैं। दोनों में से एक ही माँगें। |
| naadi_porutham | — | नाड़ी कूट, शारीरिक प्रकृति का परीक्षण। इसका भार सबसे ज़्यादा, 8 अंक, है, और परंपरा में इसमें बेमेल हो, तो उसे किसी तर्क से टाला नहीं जा सकता। [अंक, 8] लौटाती है, जिसमें अंक 0 या 8 होता है। |
| naadi_porutham_south | — | नाड़ी का दक्षिण भारतीय रूप: true, जब दोनों नक्षत्र अलग-अलग नाड़ियों में हों। बूलियन लौटाती है; इसका true उत्तर भारतीय रूप के 8 अंकों के बराबर है। |
| raasi_adhipathi_porutham | — | ग्रह मैत्री कूट: दोनों चंद्र राशियों के स्वामियों की मित्रता, जिसके 5 अंक हैं। [अंक, 5.0] लौटाती है, जिसमें अंक 0, 0.5, 1, 3, 4 या 5 होता है। |
| raasi_adhipathi_porutham_south | — | ग्रह मैत्री का दक्षिण भारतीय रूप, जो स्वामियों की मित्रता की एक अलग तालिका से देखा जाता है। पूर्णांक 0 या 1 लौटाती है — ध्यान दें, यह संख्या है, ज़्यादातर दूसरी `_south` keys की तरह बूलियन नहीं। |
| raasi_from_nakshatra_pada | nakshatra_number, paadha_number | किसी नक्षत्र का दिया गया पद किस चंद्र राशि में पड़ता है। `nakshatra_number` (1–27) और `paadha_number` (1–4) लेती है — ध्यान दें कि ये boy/girl वाले फ़ील्ड से अलग अनुरोध फ़ील्ड हैं — और मेष से मीन के लिए 1–12 का एक पूर्णांक लौटाती है। |
| raasi_porutham | — | भकूट, जो दोनों चंद्र राशियों के बीच की दूरी देखता है; इसके 7 अंक हैं। [अंक, 7] लौटाती है, जिसमें अंक या तो 0 होता है या 7 — बीच के अंक नहीं मिलते। |
| raasi_porutham_south | — | भकूट का दक्षिण भारतीय रूप: true ठीक तभी, जब उत्तर भारतीय रूप में पूरे 7 अंक मिलते। एक बूलियन लौटाती है। |
| rajju_porutham | — | रज्जु, जो हर नक्षत्र को शरीर के किसी अंग (सिर, गर्दन, पेट, कमर या पैर) से जोड़ता है और पति की आयु से संबंधित है। एक बूलियन लौटाती है: true, जब दोनों नक्षत्र एक ही रज्जु समूह में हों। |
| rajju_porutham_south | — | रज्जु का दक्षिण भारतीय रूप, जिसमें आठ हिस्सों वाला ज़्यादा बारीक विभाजन है: शरीर का हर अंग आरोही (aaroga) और अवरोही (avaroga) दो हिस्सों में बँटा है। एक बूलियन लौटाती है, और समूह अलग तरह से बने हैं, इसलिए इसका नतीजा `rajju_porutham` से अलग हो सकता है। |
| sthree_dheerga_porutham | — | स्त्री दीर्घ, जो देखता है कि वर का नक्षत्र वधू के नक्षत्र से इतना आगे है या नहीं कि विवाह लंबा चले। true, जब वधू के नक्षत्र से वर के नक्षत्र तक की गिनती 15 से ज़्यादा हो। एक बूलियन लौटाती है। |
| sthree_dheerga_porutham_south | — | `sthree_dheerga_porutham` जैसा ही — वही 15 से ज़्यादा गिनती वाला नियम, बूलियन के रूप में। |
| varna_porutham | — | वर्ण कूट, जाति या आध्यात्मिक स्वभाव का परीक्षण, जिसका 1 अंक है। [अंक, 1] लौटाती है, जिसमें अंक 0 या 1 होता है। |
| vasiya_porutham | use_astroyogi_method | वश्य कूट, जो मापता है कि दोनों साथी एक-दूसरे की ओर कितना खिंचते हैं और एक-दूसरे से कितना प्रभावित होते हैं; इसके 2 अंक हैं। [अंक, 2.0] लौटाती है, जिसमें अंक 0, 0.5, 1 या 2 होता है। `use_astroyogi_method` को true करने पर एक दूसरी तालिका इस्तेमाल होती है, जिसके अंक 0, 1, 1.5 या 2 होते हैं। |
| vasiya_porutham_south | — | वश्य का दक्षिण भारतीय रूप: सीधा true/false, कि वर की चंद्र राशि उन राशियों में है या नहीं जिन्हें वधू की राशि अपनी ओर खींचती है। उत्तर भारतीय रूप के [अंक, अधिकतम] जोड़े के बजाय बूलियन लौटाती है। |
| vedha_porutham | — | वेध, उन नक्षत्रों का परीक्षण जो एक-दूसरे को 'वेधते' हैं। true, जब दोनों नक्षत्र संख्याओं का योग 19, 28 या 37 न हो, क्योंकि यही दोषपूर्ण जोड़ियाँ हैं। एक बूलियन लौटाती है। |
| vedha_porutham_south | — | `vedha_porutham` जैसा ही — दक्षिण भारतीय रूप सीधे उसी को बुलाता है, इसलिए दोनों keys एक ही बूलियन लौटाती हैं। |
| yoni_porutham | — | योनि कूट: दोनों नक्षत्रों के पशु-प्रतीकों से देखी जाने वाली यौन और सहज अनुकूलता, जिसके 4 अंक हैं। [अंक, 4] लौटाती है, जिसमें अंक 0 से 4 तक का पूर्णांक होता है। |
| yoni_porutham_south | — | योनि का दक्षिण भारतीय रूप: true, बशर्ते दोनों पशु-प्रतीक कोई ज्ञात शत्रु जोड़ी न बनाते हों। एक बूलियन लौटाती है। |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/ashtakoota/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["raasi_from_nakshatra_pada"],"boy_nakshatra_number":5,"boy_paadham_number":3,"girl_nakshatra_number":12,"girl_paadham_number":2,"method":"North","nakshatra_number":0,"paadha_number":0,"use_astroyogi_method":true}'उत्तर
{
"data": {
"raasi_from_nakshatra_pada": 1
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं, हर नतीजा उसी नाम से जिससे आपने माँगा।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।