/api/astro/horoscope-match/1 क्रेडिटविवाह मिलान
दो नक्षत्र संख्याओं के बजाय दो जन्म विवरणों से पूरा अष्टकूट विवाह मिलान। दोनों की जन्म तारीख़, समय और स्थान दें, और एंडपॉइंट ख़ुद चंद्र राशि, नक्षत्र और पद निकालता है, आठों कूटों को 36 में से अंक देता है, मिलान रोकने वाले दो दोषों की जाँच करता है और निर्णय देता है। उत्तर के चार हिस्से हैं। `boy` और `girl` में हर कुंडली का सार है: चंद्र राशि, नक्षत्र का नाम और संख्या, पद, चंद्रमा का भोगांश और लग्न राशि। `gunas` आठ ऑब्जेक्ट की सूची है, हर कूट का एक; हर एक में उसकी `key` और `label`, `max_points` और `obtained_points`, जिन `boy_value` और `girl_value` की तुलना हो रही है (वर्ण, योनि का पशु, गण आदि), वह `area_of_life` जिससे कूट जुड़ा है, और सरल अंग्रेज़ी में `description` — नतीजों की तालिका बनाने के लिए इतना काफ़ी है, कोई पाठ लिखना नहीं पड़ता। फिर आते हैं `total_score`, 36 वाला `max_score` और 18 वाला `minimum_recommended_score`। आख़िर में `doshas`, `verdict` और `verdict_reason`। नाड़ी में शून्य अंक हों, तो नाड़ी दोष बनता है, और भकूट में शून्य हों, तो भकूट दोष; दोनों में से कोई भी हो, तो कुल अंक कुछ भी हों, निर्णय 'Union is NOT Recommended' होता है। वरना 28 या ज़्यादा पर 'Union is Excellent', 18 या ज़्यादा पर 'Union is Good', और उससे कम पर मिलान की सलाह नहीं दी जाती। हर साथी के ऑब्जेक्ट में `date_time`, `latitude`, `longitude` और `timezone_as_float` चाहिए, और चाहें तो `name` और `city` लेबल भी, जो बिना बदले वापस लौटा दिए जाते हैं। अयनांश हमेशा Lahiri रहता है; `ayanamsa` फ़ील्ड स्वीकार तो होता है, पर उसका कोई असर नहीं होता।
https://api.occultapi.com/api/astro/horoscope-match/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| boy | object | ज़रूरी | तय keys वाला ऑब्जेक्ट: name (स्ट्रिंग, वैकल्पिक, फ़्री-फ़ॉर्म लेबल), date_time (ज़रूरी, ISO-8601), latitude (ज़रूरी, -89.9..89.9), longitude (ज़रूरी, -180..180), timezone_as_float (ज़रूरी, -12.0..14.0), city (स्ट्रिंग, वैकल्पिक, फ़्री-फ़ॉर्म लेबल)। `name` और `city` जाँचे नहीं जाते, और गणना पर इनका कोई असर नहीं होता। |
| girl | object | ज़रूरी | ऑब्जेक्ट - `boy` जैसा ही ढाँचा और नियम। |
| ayanamsa | string | वैकल्पिक |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/horoscope-match/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"boy":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5},"girl":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}}'उत्तर
{
"data": {
"boy": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"girl": {
"name": "",
"city": "",
"moon_sign": "Aries",
"nakshatra": "Ashwini",
"nakshatra_number": 1,
"paadha_number": 1,
"moon_longitude": 1.478,
"ascendant_sign": "Leo"
},
"gunas": [
{
"key": "varna",
"label": "Varna",
"max_points": 1,
"obtained_points": 1,
"boy_value": "Brahmin",
"girl_value": "Brahmin",
"area_of_life": "Obedience",
"description": "Varna Kuta is assigned 1 point. It represents mutual love, comfort and obedience - the spiritual compatibility between the couple."
},
{
"key": "vashya",
"label": "Vashya",
"max_points": 2,
"obtained_points": 2,
"boy_value": "Chatushpada",
"girl_value": "Chatushpada",
"area_of_life": "Mutual Control",
"description": "Vashya Kuta is assigned 2 points. It represents mutual control or dominance, along with friendship and amenability between the couple."
},
{
"key": "tara",
"label": "Tara",
"max_points": 3,
"obtained_points": 3,
"boy_value": "Sampat",
"girl_value": "Sampat",
"area_of_life": "Luck",
"description": "Tara Kuta is assigned 3 points. It represents luck, auspiciousness and the transmission of mutual well-being between the couple."
},
{
"key": "yoni",
"label": "Yoni",
"max_points": 4,
"obtained_points": 4,
"boy_value": "Horse",
"girl_value": "Horse",
"area_of_life": "Sexual Aspects",
"description": "Yoni Kuta is assigned 4 points. It represents sexual aspects, including compatibility of intimate temperament."
},
{
"key": "maitri",
"label": "Maitri",
"max_points": 5,
"obtained_points": 5,
"boy_value": "Mars",
"girl_value": "Mars",
"area_of_life": "Affection",
"description": "Maitri (Graha Maitri) Kuta is assigned 5 points. It represents psychological disposition, mental qualities and affection between the couple."
},
{
"key": "gana",
"label": "Gana",
"max_points": 6,
"obtained_points": 6,
"boy_value": "Deva",
"girl_value": "Deva",
"area_of_life": "Nature",
"description": "Gana Kuta is assigned 6 points. It represents nature, temperament, longevity, wealth and love."
},
{
"key": "bhakoot",
"label": "Bhakoot",
"max_points": 7,
"obtained_points": 7,
"boy_value": "Mesha",
"girl_value": "Mesha",
"area_of_life": "Love",
"description": "Bhakoot (Rashi) Kuta is assigned 7 points. It represents children, wealth, comfort, good luck and growth of the family."
},
{
"key": "nadi",
"label": "Nadi",
"max_points": 8,
"obtained_points": 0,
"boy_value": "Aadi",
"girl_value": "Aadi",
"area_of_life": "Health",
"description": "Nadi Kuta is assigned 8 points, the most important of all. It represents temperament, health, and genetic compatibility for progeny."
}
],
"total_score": 28,
"max_score": 36,
"minimum_recommended_score": 18,
"doshas": [
"Nadi Dosha"
],
"verdict": "Union is NOT Recommended",
"verdict_reason": "due to Nadi Dosha"
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।