/api/astro/seasons/1 क्रेडिटविषुव, अयनांत और ऋतुएँ
किसी वर्ष के दो विषुव, दो अयनांत और छह भारतीय ऋतुएँ। हर सौर क्षण के नाम में उसका महीना होता है, और सभी क्षण समय के क्रम में लौटाए जाते हैं। यह ज़रूरी है: अंदर का डेटा दिसंबर वाला अयनांत पहले देता है, इसलिए पहली प्रविष्टि को जून वाला मान लेना आधी बार गलत निकलेगा। ऋतुएँ — वसंत, ग्रीष्म, वर्षा, शरद, हेमंत और शिशिर — भारतीय ऋतु-विभाजन हैं और चार मौसमों वाले कैलेंडर से मेल नहीं खातीं: ये छह हैं, हर एक लगभग दो महीने की, और अयनांतों से नहीं, सूर्य की निरयन स्थिति से तय होती हैं।
https://api.occultapi.com/api/astro/seasons/
ऑथेंटिकेशन
अपनी कुंजी 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/seasons/ \
-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,
"equinoxes": [
{
"name": "March",
"moment": "2025-03-20T09:01:29Z"
},
{
"name": "September",
"moment": "2025-09-22T18:19:20Z"
}
],
"solstices": [
{
"name": "June",
"moment": "2025-06-21T02:42:16Z"
},
{
"name": "December",
"moment": "2025-12-21T15:03:05Z"
}
],
"ritus": [
{
"ritu": "Vasant",
"name": "Vasant Ritu (Indian Spring)",
"subtitle": "Spring - Vasant",
"begins": "2025-02-18T10:06:34Z",
"ends": "2025-04-19T19:56:00Z",
"tropical_zodiac": [
"Pisces",
"Aries"
],
"note": "Vernal Equinox occurs at the middle of Vasant Ritu",
"image_url": "https://res.cloudinary.com/dd5qujmj9/image/upload/v1785388301/Vasanta_Ritu_muqpf3.svg"
},
{
"ritu": "Grishma",
"name": "Grishma Ritu (Indian Summer)",
"subtitle": "Summer - Grishma",
"begins": "2025-04-19T19:56:00Z",
"ends": "2025-06-21T02:42:16Z",
"tropical_zodiac": [
"Taurus",
"Gemini"
],
"note": "Grishma Ritu ends with Summer Solstice",
"image_url": "https://res.cloudinary.com/dd5qujmj9/image/upload/v1785388300/Grishma_Ritu_vhdu0v.svg"
},
{
"ritu": "Varsha",
"name": "Varsha Ritu (Indian Monsoon)",
"subtitle": "Monsoon - Varsha",
"begins": "2025-06-21T02:42:16Z",
"ends": "2025-08-22T20:33:52Z",
"tropical_zodiac": [
"Cancer",
"Leo"
],
"note": "Varsha Ritu starts with Summer Solstice",
"image_url": "https://res.cloudinary.com/dd5qujmj9/image/upload/v1785388301/Varsha_Ritu_tvqnhl.svg"
},
{
"ritu": "Sharad",
"name": "Sharad Ritu (Indian Autumn)",
"subtitle": "Autumn - Sharad",
"begins": "2025-08-22T20:33:52Z",
"ends": "2025-10-23T03:50:55Z",
"tropical_zodiac": [
"Virgo",
"Libra"
],
"note": "Autumnal Equinox occurs at the middle of Sharad Ritu",
"image_url": "https://res.cloudinary.com/dd5qujmj9/image/upload/v1785388302/Sharad_Ritu_nvzy4z.svg"
},
{
"ritu": "Hemant",
"name": "Hemant Ritu (Indian Prewinter)",
"subtitle": "Prewinter - Hemant",
"begins": "2025-10-23T03:50:55Z",
"ends": "2025-12-21T15:03:05Z",
"tropical_zodiac": [
"Scorpio",
"Sagittarius"
],
"note": "Hemant Ritu ends with Winter Solstice",
"image_url": "https://res.cloudinary.com/dd5qujmj9/image/upload/v1785388300/Hemanta_Ritu_a3sole.svg"
},
{
"ritu": "Shishir",
"name": "Shishir Ritu (Indian Winter)",
"subtitle": "Winter - Shishir",
"begins": "2025-12-21T15:03:05Z",
"ends": "2026-02-18T15:51:55Z",
"tropical_zodiac": [
"Capricorn",
"Aquarius"
],
"note": "Shishir Ritu starts with Winter Solstice",
"image_url": "https://res.cloudinary.com/dd5qujmj9/image/upload/v1785388300/Shishira_Ritu_sffdv3.svg"
}
]
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।