ओणम एक दिन का त्योहार नहीं, बल्कि लगातार आने वाले नक्षत्रों से जुड़ा एक क्रम है, जो अत्तम (हस्त) से तिरुवोणम होते हुए चतयम (शतभिषा) तक चलता है। यह एंडपॉइंट किसी वर्ष के लिए यह पूरी अवधि लौटाता है, हर कैलेंडर दिन की एक पंक्ति।
हर पंक्ति में ये होते हैं: day_number, ग्रेगोरियन तारीख़, अंग्रेज़ी और मलयालम लिपि में वार, उस दिन का नक्षत्र, कोल्लम संवत वर्ष के साथ मलयालम महीना और दिन, उस दिन क्या मनाया जाता है यह बताने वाली captions सूची (Atthachamayam, Athapoo Pookalam, Vallam Kali आदि), is_repeat_day फ़्लैग, और segments, जो स्थानीय समय में नक्षत्र के सटीक आरंभ और अंत क्षण देते हैं।
दिनों की संख्या तय नहीं है। जो नक्षत्र इतना लंबा हो कि दो सूर्योदयों तक फैल जाए, उससे एक दोहराया दिन बनता है — वही नाम, खाली captions, null आरंभ और अंत — और क्रम एक दिन आगे खिसक जाता है; इसके उलट, छोटा नक्षत्र अगले दिन में मिल सकता है, और तब उस दिन की captions में दो नाम होते हैं। बारह या तेरह पंक्तियाँ होना सामान्य है।
वर्ष के साथ अक्षांश, देशांतर और UTC ऑफ़सेट भेजें; वर्ष 2006 से 2046 के बीच होना चाहिए। केरल के पूरे वर्ष के त्योहारों के बीच ओणम की एक तारीख़ वाली प्रविष्टि चाहिए, तो /api/astro/malayalam_calendar/ इस्तेमाल करें।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
latitude
number (double)
ज़रूरी
स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude
number (double)
ज़रूरी
स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
timezone_as_float
number (double)
ज़रूरी
स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।
year
integer
ज़रूरी
जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।