/api/astro/karakamsa/1 क्रेडिटकारकांश (स्वांश)
नवांश में आत्मकारक जिस राशि में बैठा है — जैमिनी पद्धति में चरित्र और भाग्य राशि लग्न से नहीं, इसी स्थान से देखे जाते हैं। यहाँ तक पहुँचने के लिए दो कुंडलियाँ चाहिए: राशि कुंडली, यह जानने के लिए कि आत्मकारक कौन-सा ग्रह है, और नवांश, यह देखने के लिए कि वह ग्रह कहाँ बैठा है। दोनों लौटाई जाती हैं, साथ में आठों कारकों का पूरा क्रम भी, ताकि उत्तर पर आँख मूँदकर भरोसा करने के बजाय उसे जाँचा जा सके। आत्मकारक वह ग्रह है जो अपनी राशि में सबसे आगे तक बढ़ चुका हो। राहु उल्टा चलता है, इसलिए उसे उल्टा मापा जाता है; केतु इस गणना में शामिल नहीं होता। ध्यान दें: यह कारकों का क्रम राशि के भीतर के अंशों से तय करता है, और ज़्यादातर कुंडलियों में /api/astro/chara-karakas/ से अलग आत्मकारक बताएगा। दोनों की गणना अलग तरीके से होती है और इन्हें एक-दूसरे की जगह इस्तेमाल नहीं किया जा सकता — कारकांश के काम के लिए इसी को चुनें।
https://api.occultapi.com/api/astro/karakamsa/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| date_time | string (date-time) | ज़रूरी | जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| ayanamsa | string | वैकल्पिक | |
| timezone_as_float | number (double) | वैकल्पिक | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/karakamsa/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'उत्तर
{
"data": {
"system": "jaimini",
"atmakaraka": "sun",
"atmakaraka_rashi": "Cancer",
"atmakaraka_degree_in_sign": 28.395,
"karakamsa": "Pisces",
"karakamsa_house": 12,
"also_called": "swamsa",
"navamsa_longitude": 345.5525,
"karakas": [
{
"karaka": "atma_karaka",
"signifies": "Self",
"planet": "sun",
"degree_in_sign": 28.395
},
{
"karaka": "amatya_karaka",
"signifies": "Career and counsel",
"planet": "mars",
"degree_in_sign": 27.487
},
{
"karaka": "bhratri_karaka",
"signifies": "Siblings",
"planet": "saturn",
"degree_in_sign": 26.148
},
{
"karaka": "maitri_karaka",
"signifies": "Friends",
"planet": "mercury",
"degree_in_sign": 25.446
},
{
"karaka": "pitri_karaka",
"signifies": "Father",
"planet": "moon",
"degree_in_sign": 18.93
},
{
"karaka": "putra_karaka",
"signifies": "Children",
"planet": "rahu",
"degree_in_sign": 16.497
},
{
"karaka": "jnaati_karaka",
"signifies": "Kin and obstacles",
"planet": "venus",
"degree_in_sign": 7.843
},
{
"karaka": "dara_karaka",
"signifies": "Spouse",
"planet": "jupiter",
"degree_in_sign": 5.607
}
],
"note": "The Atmakaraka is the graha with the highest degree WITHIN its sign; Rahu is measured in reverse and Ketu excluded. Karakamsa is that graha's NAVAMSA sign, not its rashi. This ranking is computed from degree within the sign and will differ from /api/astro/chara-karakas/."
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।