/api/astro/vimsamsa/1 क्रेडिटविंशांश (D20)
विंशांश, बीसवीं वर्ग कुंडली: इसमें हर राशि बीस भागों में बँटी होती है, हर भाग 1°30' का। आध्यात्मिक साधना और उपासना के लिए देखी जाती है - उपासना, व्यक्ति किस देवता की ओर खिंचता है, और साधना कितनी टिकती है। उत्तर का ढाँचा /api/astro/planet-positions/ जैसा ही फ़्लैट है: ग्रहों की सूची पारंपरिक क्रम में, हर ग्रह के साथ `name`, भोगांश, राशि, नक्षत्र, पद और भाव, और साथ में लग्न व लागू किया गया अयनांश। कुंडली रूट से तय होती है, इसलिए बॉडी में भेजा गया `chart_name` माना नहीं जाता, अनदेखा कर दिया जाता है - यह एंडपॉइंट इस वर्ग के सिवा कुछ नहीं लौटा सकता।
https://api.occultapi.com/api/astro/vimsamsa/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| chart_name | string | ज़रूरी | |
| datetime | string (date-time) | ज़रूरी | जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है। इसका अर्थ date_time जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| aberration | boolean | वैकल्पिक | |
| apply_correction | boolean | वैकल्पिक | |
| ascendant_pos | string | वैकल्पिक | cuspstartend |
| ayanamsa | string | वैकल्पिक | |
| background_color | string | वैकल्पिक | SVG की पृष्ठभूमि का हेक्स रंग। |
| chart_style | string | वैकल्पिक | render='svg' होने पर चार्ट की शैली। 'north' हीरे के आकार वाला लेआउट है, जिसमें भाव अपनी जगह रहते हैं और राशियाँ घूमती हैं; 'south' ग्रिड वाला लेआउट है, जिसमें राशियाँ अपनी जगह रहती हैं और भाव घूमते हैं। northsouth |
| correction_deg | integer | वैकल्पिक | min 0 |
| correction_direction | string | वैकल्पिक | addsubtract |
| correction_min | integer | वैकल्पिक | min 0 · max 59 |
| correction_sec | integer | वैकल्पिक | min 0 · max 59 |
| extended_bodies | array | वैकल्पिक | किन पिंड-समूहों को शामिल करना है: 'asteroids', 'planetary_moons', 'fictitious_bodies'। |
| label_style | string | वैकल्पिक | ग्रहों के लेबल किस रूप में हों: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) या 'symbol' (☉, ☽, ...)। englishsanskritsymbol |
| line_color | string | वैकल्पिक | चार्ट की ग्रिड रेखाओं का हेक्स रंग। |
| notation | string | वैकल्पिक | astrologicaldegree |
| nutation | boolean | वैकल्पिक | |
| planet_color | string | वैकल्पिक | ग्रहों के लेबल का हेक्स रंग, जैसे '#111827'। डिफ़ॉल्ट रूप से थीम का अपना रंग। |
| rahu | string | वैकल्पिक | कौन-सा पात शामिल करना है। 'true' देने पर केवल स्पष्ट पात, 'mean' पर केवल मध्यम पात, और 'both' पर दोनों मिलते हैं। truemeanboth |
| refraction | boolean | वैकल्पिक | |
| render | string | वैकल्पिक | 'svg' दें, तो साथ में रेंडर किया हुआ चार्ट डायग्राम (chart_style देखें) और उसकी ज्यामिति भी मिलती है। इसे न भेजें, तो उत्तर में कोई बदलाव नहीं होता। nonesvg |
| show_degrees | boolean | वैकल्पिक | हर पिंड के लेबल के पास, उसकी राशि में उसका अंश भी दिखाएँ। |
| sign_color | string | वैकल्पिक | राशि संख्याओं/संक्षिप्त नामों का हेक्स रंग। |
| svg_size | integer | वैकल्पिक | वर्गाकार SVG viewBox की चौड़ाई और ऊँचाई, पिक्सेल में। min 100 · max 2000 |
| theme | string | वैकल्पिक | lightdark |
| true_mean | string | वैकल्पिक | TrueMean |
| use_28_nakshatras | boolean | वैकल्पिक |
उदाहरण अनुरोध
यह उदाहरण अभी जाँचा नहीं गया है
नीचे के फ़ील्ड के नाम और टाइप API की परिभाषा से लिए गए हैं और सही हैं। पर पिछली बार चलाने पर यह बॉडी सफल नहीं हुई — शायद इसे कोई ऐसा मान चाहिए जिसका हम अंदाज़ा नहीं लगा पाए। इसे तैयार कमांड नहीं, शुरुआत भर समझें।
curl -X POST https://api.occultapi.com/api/astro/vimsamsa/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"chart_name":"string","datetime":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"ascendant_pos":"cusp","chart_style":"north","correction_direction":"add","label_style":"english","notation":"astrological","rahu":"true","render":"none","theme":"light","true_mean":"True"}'उत्तर
इस एंडपॉइंट का जाँचा हुआ उदाहरण उत्तर अभी उपलब्ध नहीं है। ऊपर अनुरोध का ढाँचा API की परिभाषा से बना है और सही है; उत्तर के नमूने हम तभी दिखाते हैं जब वे असली कॉल पर खरे उतर चुके हों।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।