/api/astro/compatibility_match/1 क्रेडिटसाथी नक्षत्र खोज
वधू और वर के नक्षत्र-पद के सभी 11,664 संयोजनों की पहले से तैयार तालिका में उल्टी खोज। यह किसी एक जोड़े को अंक नहीं देता, बल्कि दूसरा सवाल हल करता है: किसी एक व्यक्ति का जन्म नक्षत्र और पद पता हो, तो कौन-से नक्षत्र और पद उससे अच्छा मेल खाते हैं? वर का नक्षत्र तय करें, तो उसके लिए अनुकूल वधुएँ मिलेंगी; वधू का तय करें, तो वर। हर पंक्ति `[star, pada, [the koota scores], score, [the supplementary tests]]` के रूप में आती है। उत्तर भारतीय तालिका की जगह दक्षिण भारतीय तालिका में खोजना हो, तो `method` में कोई भी ऐसी वैल्यू दें जिसमें 'south' हो। दो बातें आपको चौंकाएँगी, इसलिए पहले से इनका ध्यान रखें। `minimum_score` की तुलना 36 अंकों के कुल योग से नहीं, नाड़ी वाले कॉलम से होती है, और नाड़ी हमेशा 0 या 8 ही होती है; ऊपर से `minimum_score` में 0 देने को 'नहीं भेजा' माना जाता है, और डिफ़ॉल्ट लग जाता है, जो उत्तर भारतीय के लिए 18 और दक्षिण भारतीय के लिए 16 है। यानी डिफ़ॉल्ट से खाली सूची मिलती है, और कोई भी पंक्ति पाने के लिए 8 या उससे कम, पर 0 नहीं, वैल्यू देनी पड़ती है। इसी तरह चारों `advanced_checks` फ़्लैग अपने नाम वाले परीक्षण से एक कॉलम बाईं ओर पढ़ते हैं, इसलिए 'mahendra' कुल अंकों पर छाँटता है और किसी से मेल नहीं खाता, जबकि 'vedha', 'rajju' और 'shree' क्रमशः माहेंद्र, वेध और रज्जु पर छाँटते हैं। किसी एक जोड़े के अंक चाहिए, तो /api/astro/ashtakoota/ इस्तेमाल करें।
https://api.occultapi.com/api/astro/compatibility_match/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| boy_nakshatra | integer | ज़रूरी | |
| boy_paadham | integer | ज़रूरी | |
| girl_nakshatra | integer | ज़रूरी | |
| girl_paadham | integer | ज़रूरी | |
| method | string | ज़रूरी | NorthSouthकेस-असंवेदी, और आंशिक मिलान से: जिस भी वैल्यू में 'south' हो, उससे दक्षिण भारतीय डेटा सेट (all_nak_pad_boy_girl_south.csv) चुना जाता है, जिसमें minimum_score का डिफ़ॉल्ट 16 है; बाकी किसी भी वैल्यू से उत्तर भारतीय डेटा सेट, जिसमें minimum_score का डिफ़ॉल्ट 18 है। आगे इंजन को भेजा जाता है। |
| minimum_score | integer | ज़रूरी | |
| advanced_checks | object | वैकल्पिक | mahendravedharajjushreeऐसा ऑब्जेक्ट, जिसकी keys तय हैं (वैल्यू बूलियन होती हैं)। keys का मिलान केस-असंवेदी होता है (check.lower); इनके सिवा कोई भी key हो, तो वह बिना बताए अनदेखी कर दी जाती है। |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/compatibility_match/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"boy_nakshatra":1,"boy_paadham":1,"girl_nakshatra":5,"girl_paadham":2,"method":"South","minimum_score":0,"advanced_checks":{"mahendra":true,"vedha":true,"rajju":true,"shree":true}}'उत्तर
{
"data": {
"compatibility_matcher": []
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।