curl -X POST https://api.occultapi.com/api/astro/chinese/four-pillars/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1984-06-15T14:30:00+08:00","latitude":39.9042,"longitude":116.4074,"timezone_as_float":8}'जन्म के चार स्तंभ: वर्ष, मास, दिन और घंटा। हर स्तंभ में एक हेवनली स्टेम एक अर्थली ब्रांच के ऊपर होता है, और दोनों के साठ जोड़ मिलकर साठ का चक्र बनाते हैं। दिन का स्टेम डे मास्टर (DAY MASTER) है — चार्ट का सबसे अहम तत्व, क्योंकि बाकी सब कुछ उसी से संबंध के रूप में पढ़ा जाता है। चीनी वर्ष LICHUN से शुरू होता है — वह क्षण जब सूर्य 315 अंश सायन भोगांश पर पहुँचता है, लगभग 4 फ़रवरी को। 1 जनवरी नहीं, और चीनी नववर्ष भी नहीं; नववर्ष एक चांद्र तारीख़ है, जो 21 जनवरी से 20 फ़रवरी के बीच खिसकती रहती है और त्योहार तय करती है, चार्ट नहीं। 20 जनवरी 2024 को जन्मे व्यक्ति का स्तंभ 2023 का है: जल खरगोश, काष्ठ ड्रैगन नहीं। सस्ते इम्प्लीमेंटेशन ठीक यही गलती करते हैं, और इससे जनवरी में जन्मे हर व्यक्ति का वर्ष गलत तय हो जाता है। मास के स्तंभों की सीमाएँ भी इसी तरह बारह प्रमुख सौर पदों (solar terms) से तय होती हैं, इसलिए मास बदलने का समय एक खगोलीय क्षण है, जो कैलेंडर मास की पहली तारीख़ पर नहीं, किसी भी दिन के किसी भी घंटे में पड़ सकता है। दो परिपाटियाँ आपके चुनने के लिए खुली हैं, क्योंकि ज्योतिषी इन पर सच में अलग-अलग राय रखते हैं, और दोनों से नतीजा बदलता है। `day_boundary` तय करता है कि दिन 23:00 (पारंपरिक) पर बदले या मध्यरात्रि पर। `true_solar_time` घड़ी के समय को इस हिसाब से ठीक करता है कि जन्म स्थान अपने समय क्षेत्र के याम्योत्तर से कितनी दूर है — बीजिंग के लिए लगभग चौदह मिनट — और इससे घंटे का स्तंभ एक जगह खिसक सकता है।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। |
| day_boundary | string | वैकल्पिक | दिन का स्तंभ कब बदलता है। 'zi_hour' यानी 23:00, जो पारंपरिक नियम है; 'midnight' यानी मध्यरात्रि, जो ज़्यादातर सॉफ़्टवेयर मानते हैं। 23:00 और 24:00 के बीच हुए जन्मों के लिए दोनों के नतीजे अलग आते हैं। zi_hourmidnight |
| keys | array | वैकल्पिक | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| latitude | number (double) | वैकल्पिक | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। |
| longitude | number (double) | वैकल्पिक | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। |
| orb_factor | number (double) | वैकल्पिक | सभी दृष्टियों के ऑर्ब एक साथ घटाएँ-बढ़ाएँ। 0.5 देने पर ऑर्ब आधे हो जाते हैं, 2 देने पर दोगुने। min 0.1 · max 2 |
| timezone_as_float | number (double) | वैकल्पिक | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
| true_solar_time | boolean | वैकल्पिक | समय क्षेत्र के याम्योत्तर से स्थान के देशांतर का जितना अंतर है, उसके हिसाब से घंटे में सुधार करें। परंपरा में वास्तविक स्थानीय सौर समय लिया जाता है, और इससे घंटे का स्तंभ एक जगह खिसक सकता है। |