/api/astro/kalsarp/1 क्रेडिटकाल सर्प योग
कुंडली में काल सर्प योग बनता है या नहीं — यानी सूर्य से शनि तक के सातों ग्रह उन दो अर्धवृत्तों में से किसी एक में घिरे हैं या नहीं, जिनमें राहु–केतु अक्ष राशिचक्र को बाँटता है — और अगर बनता है, तो वह बारह नाम वाले रूपों में से कौन-सा है। ज़्यादातर कुंडलियों में काल सर्प नहीं बनता: अक्ष के दूसरी ओर एक भी ग्रह हो, तो योग टूट जाता है। इसलिए यह सिर्फ़ हाँ या ना नहीं लौटाता। `between_rahu_and_ketu` और `between_ketu_and_rahu` बताते हैं कि कौन-सा ग्रह किस ओर पड़ा। इससे आप देख सकते हैं कि उत्तर ऐसा क्यों आया — और यह भी कि कुंडली एक ग्रह से चूकी या चार से। बारह नाम (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag) इस पर निर्भर हैं कि राहु किस भाव में है, और `name` तभी भरा जाता है जब योग सचमुच बनता हो — जो कुंडली बस करीब आकर रह गई, उसके लिए कभी नहीं। जो ग्रह किसी भी पात से एक अंश के भीतर हो, वह किसी भी ओर का नहीं माना जाता। ऐसे ग्रह `conjunct_a_node` में दिए जाते हैं और `partial` सेट करते हैं; फ़ैसला निकालने के लिए उन्हें ज़बरदस्ती किसी एक ओर नहीं रखा जाता। स्थितियाँ /api/astro/planet-positions/ वाले इंजन से ही आती हैं, इसलिए भोगांश हूबहू एक जैसे होते हैं।
https://api.occultapi.com/api/astro/kalsarp/ऑथेंटिकेशन
अपनी कुंजी 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/kalsarp/ \
-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": {
"yoga": "Kala Sarpa",
"formed": false,
"partial": false,
"name": null,
"rahu_house": 5,
"rahu_longitude": 283.503,
"ketu_longitude": 103.503,
"between_rahu_and_ketu": [
"moon",
"mars",
"jupiter",
"venus"
],
"between_ketu_and_rahu": [
"sun",
"mercury",
"saturn"
],
"conjunct_a_node": [],
"direction": null,
"note": "Formed when all seven grahas fall in one of the two semicircles the Rahu-Ketu axis makes. A graha within 1.0 degree of a node is listed under conjunct_a_node rather than assigned a side, and makes the yoga partial rather than formed."
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।