/api/astro/samvatsara/1 क्रेडिटहिंदू वर्ष के अधिपति
हिंदू वर्ष के राजा, मंत्री और आठ अन्य अधिपति। संवत्सर के आरंभ पर कुंडली बनाई जाती है, और आने वाले बारह महीनों के लिए अलग-अलग ग्रहों को अलग-अलग पद मिलते हैं: राजा पूरे वर्ष पर, मंत्री शासन पर, और बाकी अधिपति वर्षा, धन, अन्न, रस, जल, फल, फ़सल और रक्षा पर। पंचांग प्रकाशक अपनी वार्षिक भविष्यवाणियाँ इसी ढाँचे में लिखते हैं। हर पद के साथ यह भी मिलता है कि उसके अधीन क्या है, जैसे `neersesha_of_year` के साथ 'Lord of Water, governs rivers and water supply' आता है। साथ में वर्ष शुरू होने का क्षण और संवत्सर का वाहन भी लौटाया जाता है। जन्म कुंडली की ज़रूरत नहीं। पर स्थान मायने रखता है: हर पद उस स्थानीय दिन (सूर्योदय से सूर्योदय तक) के स्वामी को मिलता है जिस दिन उसकी घटना पड़ती है, इसलिए एक ही वर्ष के लिए दो शहरों के अधिपति अलग हो सकते हैं। `year` वह ग्रेगोरियन वर्ष है जिसमें संवत शुरू होता है।
https://api.occultapi.com/api/astro/samvatsara/ऑथेंटिकेशन
अपनी कुंजी 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 |
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
| year | integer | ज़रूरी | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। |
| keys | array | वैकल्पिक | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| nakshatra | string | वैकल्पिक | केवल /nakshatra-chakras/ इसे पढ़ता है; बाकी जगह अनदेखा किया जाता है। |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/samvatsara/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2025,"date_time":"2025-02-13T05:00:37Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'उत्तर
{
"data": {
"year": 2025,
"year_begins": "2025-03-30T06:23:38+05:30",
"vaahana": "Horse",
"cabinet": [
{
"office": "King (Raja)",
"key": "king_of_year",
"governs": "the year as a whole",
"planet": "Sun"
},
{
"office": "Minister (Mantri)",
"key": "mantri_of_year",
"governs": "governance and counsel",
"planet": "Sun"
},
{
"office": "Lord of Clouds (Meghesha)",
"key": "meghesha_of_year",
"governs": "rainfall",
"planet": "Sun"
},
{
"office": "Lord of Wealth (Dhanesha)",
"key": "dhanesha_of_year",
"governs": "money and trade",
"planet": "Mars"
},
{
"office": "Lord of Grain (Dhaanyesha)",
"key": "dhaanyesha_of_year",
"governs": "the grain harvest",
"planet": "Moon"
},
{
"office": "Lord of Juices (Rasesha)",
"key": "rasesha_of_year",
"governs": "sap, juices and liquids",
"planet": "Venus"
},
{
"office": "Lord of Water (Neeresha)",
"key": "neersesha_of_year",
"governs": "rivers and water supply",
"planet": "Mercury"
},
{
"office": "Lord of Fruit (Phalesha)",
"key": "phalesha_of_year",
"governs": "fruit crops",
"planet": "Saturn"
},
{
"office": "Lord of Crops (Sashyesha)",
"key": "sashyesha_of_year",
"governs": "standing crops",
"planet": "Mercury"
},
{
"office": "Lord of Forts (Durgesha)",
"key": "durgesha_of_year",
"governs": "defence and strongholds",
"planet": "Saturn"
}
],
"das_adhikari": {
"King": "Sun",
"Minister": "Sun",
"Lord of Clouds": "Sun",
"Lord of Summer Crops": "Mercury",
"Lord of Defence": "Saturn",
"Lord of Treasury": "Mars",
"Lord of Juicy Products": "Venus",
"Lord of Food Grains": "Moon",
"Lord of Metals": "Mercury",
"Lord of Fruits": "Saturn",
"Vehicle of Year": "Horse"
}
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।