/api/astro/chart_analysis/1 क्रेडिटकुंडली विश्लेषण
जन्म कुंडली के चौदह संरचनात्मक विश्लेषण एक ही कॉल में, और साथ में जन्म कुंडली और गोचर कुंडली की एक तुलना। यह /api/astro/chart/ के ऊपर की व्याख्या वाली परत है: यह स्थितियाँ नहीं देता, यह बताता है कि उन स्थितियों का मतलब क्या निकलता है। उत्तर में हमेशा यही फ़ील्ड होते हैं। `house_from_reference_chart` गिनता है कि गोचर कुंडली में `target_celestial` जिस भाव में है, वह जन्म कुंडली के `ref_celestial` से कौन-सा भाव पड़ता है। `kendras` जन्म कुंडली के पिंडों को केंद्र भावों के हिसाब से समूहों में रखता है। `argala` और `virodhargala` हर पिंड के लिए हस्तक्षेप करने वाले और उसे रोकने वाले ग्रह देते हैं; इनकी keys क्रमशः 2रा, 4था, 5वाँ और 11वाँ, और 12वाँ, 10वाँ, 9वाँ और 3रा भाव हैं। `bhava_arudhas` और `ghara_arudhas` भावों और ग्रहों के प्रक्षेपित प्रतिबिंब (आरूढ़) हैं। `temporary_relationships` और `compound_relationships` इसी कुंडली में बनने वाली मैत्री हैं। `karakas` चर कारक हैं, `nakshatra_count` संदर्भ पिंड से नक्षत्रों की दूरी, और `exaltation`, `debilitation`, `mooltrikona`, `own_rashi` व `pachakadi_relations` गरिमा की जाँचें। दोनों कुंडलियाँ हमेशा राशि कुंडलियाँ होती हैं: `chart_name_natal` और `chart_name_transit` फ़्री-फ़ॉर्म लेबल हैं, और नाम से जो भी लगे, ये कोई वर्ग कुंडली नहीं चुनते। `mode` से आठ या सात चर कारक चुने जाते हैं, और `rahu` केवल कारक खंड के लिए स्पष्ट या मध्यम पात चुनता है। `ref_celestial` को 'ascendant' रखा जा सकता है; तब दोनों मैत्री वाले फ़ील्ड null आते हैं, क्योंकि मैत्री परिभाषा से ही ग्रह और ग्रह के बीच होती है।
https://api.occultapi.com/api/astro/chart_analysis/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| chart_name_natal | string | ज़रूरी | फ़्री-फ़ॉर्म लेबल, कुंडली का प्रकार चुनने वाला फ़ील्ड नहीं। नाम से जो भी लगे, यह एंडपॉइंट हमेशा RashiChart ही बनाता है; यह स्ट्रिंग बस दिखाने वाले लेबल के रूप में रखी जाती है और कभी जाँची नहीं जाती। कोई भी ऐसी स्ट्रिंग चलेगी जो खाली न हो। |
| chart_name_transit | string | ज़रूरी | फ़्री-फ़ॉर्म लेबल, कुंडली का प्रकार चुनने वाला फ़ील्ड नहीं। chart_name_natal जैसा ही। |
| date_time_natal | string (date-time) | ज़रूरी | फ़ॉर्मैट की शर्त। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)। |
| date_time_transit | string (date-time) | ज़रूरी | फ़ॉर्मैट की शर्त। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)। |
| latitude_natal | number (double) | ज़रूरी | min -180 · max 180 |
| latitude_transit | number (double) | ज़रूरी | min -180 · max 180 |
| longitude_natal | number (double) | ज़रूरी | min -180 · max 180 |
| longitude_transit | number (double) | ज़रूरी | min -180 · max 180 |
| mode | integer | ज़रूरी | 78पूर्णांक, स्ट्रिंग नहीं, पर तय वैल्यू वाला: 8 = आठ चर कारक (पितृ कारक और राहु सहित), 7 = सात कारक (राहु के बिना)। केवल 7 और 8 का ही कोई अर्थ है। |
| rahu | string | ज़रूरी | truemeanकेस-संवेदी, छोटे अक्षरों में। केवल 'true' की अलग से जाँच होती है; बाकी कोई भी वैल्यू ('mean' भी else शाखा में जाती है और 'mean' की तरह ही बरती जाती है। असर केवल `karakas` खंड पर पड़ता है। |
| ref_celestial | string | ज़रूरी | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannodeकेस-संवेदी, सब छोटे अक्षरों में। house_from_reference_chart और nakshatra_count वाले हिस्सों के लिए 'ascendant' चलता है; ref_celestial='ascendant' होने पर temporary_relationships और compound_relationships फ़ील्ड जान-बूझकर null आते हैं। अनजान नाम पर 400 (KeyError) मिलता है। |
| target_celestial | string | ज़रूरी | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannodeवही वैल्यू, जो ref_celestial में चलती हैं। |
| bhava_arudha_exceptions | boolean | वैकल्पिक | |
| graha_arudha_exceptions | boolean | वैकल्पिक | |
| nakshatras | string | वैकल्पिक |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/chart_analysis/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time_natal":"2025-11-21T05:45:23.715Z","date_time_transit":"2024-11-21T05:45:23.715Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"mercury","target_celestial":"mars","rahu":"true","mode":0}'उत्तर
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"house_from_reference_chart\": {\"house_from_ref\": 9, \"zodiac_sign_in_ref\": \"Cn\"}, \"kendras\": [[\"venus\", \"jupiter\", \"pluto\"], [\"sun\", \"moon\", \"mercury\", \"mars\", \"uranus\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], [\"saturn\", \"neptune\"]], \"argala\": {\"sun\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"moon\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"mercury\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"venus\": {\"2\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"4\": [\"pluto\"], \"5\": [\"northtruenode\", \"northmeannode\"], \"11\": [\"southtruenode\", \"southmeannode\"]}, \"mars\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"jupiter\": {\"2\": [\"southtruenode\", \"southmeannode\"], \"4\": [\"venus\"], \"5\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"11\": [\"uranus\"]}, \"saturn\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"uranus\": {\"2\": null, \"4\": [\"southtruenode\", \"southmeannode\"], \"5\": null, \"11\": [\"saturn\", \"neptune\"]}, \"neptune\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"pluto\": {\"2\": [\"northtruenode\", \"northmeannode\"], \"4\": null, \"5\": [\"uranus\"], \"11\": [\"sun\", \"moon\", \"mercury\", \"mars\"]}, \"northtruenode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"northmeannode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"southtruenode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}, \"southmeannode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}}, \"virodhargala\": {\"sun\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"moon\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"mercury\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"venus\": {\"3\": null, \"9\": null, \"10\": [\"jupiter\"], \"12\": null}, \"mars\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"jupiter\": {\"3\": null, \"9\": [\"saturn\", \"neptune\"], \"10\": null, \"12\": null}, \"saturn\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"uranus\": {\"3\": [\"jupiter\"], \"9\": [\"pluto\"], \"10\": [\"northtruenode\", \"northmeannode\"], \"12\": null}, \"neptune\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"pluto\": {\"3\": [\"saturn\", \"neptune\"], \"9\": null, \"10\": [\"venus\"], \"12\": null}, \"northtruenode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"northmeannode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"southtruenode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}, \"southmeannode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}}, \"bhava_arudhas\": {\"A1\": \"Taurus\", \"A2\": \"Aries\", \"A3\": \"Scorpio\", \"A4\": \"Gemini\", \"A5\": \"Pisces\", \"A6\": \"Aries\", \"A7\": \"Pisces\", \"A8\": \"Scorpio\", \"A9\": \"Capricorn\", \"A10\": \"Cancer\", \"A11\": \"Leo\", \"A12\": \"Aquarius\"}, \"ghara_arudhas\": {\"A1\": \"Leo\", \"A2\": \"Leo\", \"A3\": \"Leo\", \"A4\": \"Cancer\", \"A5\": \"Leo\", \"A6\": \"Pisces\", \"A7\": \"Scorpio\", \"A8\": \"Pisces\", \"A9\": \"Scorpio\", \"A10\": \"Taurus\", \"A11\": \"Aries\", \"A12\": \"Aries\"}, \"temporary_relationships\": {\"friends\": [\"venus\", \"pluto\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], \"enemies\": [\"sun\", \"moon\", \"mars\", \"jupiter\", \"saturn\", \"uranus\", \"neptune\"]}, \"compound_relationships\": \"Satru\", \"karakas\": {\"ak\": {\"venus\": {\"degree\": 23, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 43}}, \"amk\": {\"mars\": {\"degree\": 17, \"sign\": \"Sc\", \"minutes\": 52, \"seconds\": 44}}, \"bk\": {\"moon\": {\"degree\": 15, \"sign\": \"Sc\", \"minutes\": 20, \"seconds\": 27}}, \"mk\": {\"northtruenode\""
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।