सीधे सामग्री पर जाएँ
POST/api/astro/onam_calendar/1 क्रेडिट

ओणम कैलेंडर

ओणम एक दिन का त्योहार नहीं, बल्कि लगातार आने वाले नक्षत्रों से जुड़ा एक क्रम है, जो अत्तम (हस्त) से तिरुवोणम होते हुए चतयम (शतभिषा) तक चलता है। यह एंडपॉइंट किसी वर्ष के लिए यह पूरी अवधि लौटाता है, हर कैलेंडर दिन की एक पंक्ति। हर पंक्ति में ये होते हैं: day_number, ग्रेगोरियन तारीख़, अंग्रेज़ी और मलयालम लिपि में वार, उस दिन का नक्षत्र, कोल्लम संवत वर्ष के साथ मलयालम महीना और दिन, उस दिन क्या मनाया जाता है यह बताने वाली captions सूची (Atthachamayam, Athapoo Pookalam, Vallam Kali आदि), is_repeat_day फ़्लैग, और segments, जो स्थानीय समय में नक्षत्र के सटीक आरंभ और अंत क्षण देते हैं। दिनों की संख्या तय नहीं है। जो नक्षत्र इतना लंबा हो कि दो सूर्योदयों तक फैल जाए, उससे एक दोहराया दिन बनता है — वही नाम, खाली captions, null आरंभ और अंत — और क्रम एक दिन आगे खिसक जाता है; इसके उलट, छोटा नक्षत्र अगले दिन में मिल सकता है, और तब उस दिन की captions में दो नाम होते हैं। बारह या तेरह पंक्तियाँ होना सामान्य है। वर्ष के साथ अक्षांश, देशांतर और UTC ऑफ़सेट भेजें; वर्ष 2006 से 2046 के बीच होना चाहिए। केरल के पूरे वर्ष के त्योहारों के बीच ओणम की एक तारीख़ वाली प्रविष्टि चाहिए, तो /api/astro/malayalam_calendar/ इस्तेमाल करें।

https://api.occultapi.com/api/astro/onam_calendar/
अनुरोध आज़माएँ
ओणम कैलेंडर का नतीजा, एक इंटरफ़ेस में
इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्डटाइपज़रूरीटिप्पणी
latitudenumber (double)ज़रूरी

स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।

longitudenumber (double)ज़रूरी

स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।

timezone_as_floatnumber (double)ज़रूरी

स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।

yearintegerज़रूरी

जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।

min 2006 · max 2046

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/astro/onam_calendar/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'

उत्तर

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"days\": [{\"day_number\": 1, \"date\": \"2026-08-16\", \"weekday_en\": \"Sunday\", \"weekday_ml\": \"ഞായറാഴ്ച\", \"nakshatra\": \"Atham\", \"malayalam_month\": \"Karkatakam\", \"malayalam_day\": 31, \"kollam_year\": 1201, \"captions\": [\"Atthachamayam\", \"Athapoo Pookalam\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Atham\", \"begin\": \"2026-08-16T03:25:45+05:30\", \"end\": \"2026-08-17T03:50:52+05:30\"}]}, {\"day_number\": 2, \"date\": \"2026-08-17\", \"weekday_en\": \"Monday\", \"weekday_ml\": \"തിങ്കളാഴ്ച\", \"nakshatra\": \"Chithira\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 1, \"kollam_year\": 1202, \"captions\": [\"Chithira Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Chithira\", \"begin\": \"2026-08-17T03:50:52+05:30\", \"end\": \"2026-08-18T04:58:59+05:30\"}]}, {\"day_number\": 3, \"date\": \"2026-08-18\", \"weekday_en\": \"Tuesday\", \"weekday_ml\": \"ചൊവ്വാഴ്ച\", \"nakshatra\": \"Chothi\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 2, \"kollam_year\": 1202, \"captions\": [\"Chodhi Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Chothi\", \"begin\": \"2026-08-18T04:58:59+05:30\", \"end\": \"2026-08-19T06:47:04+05:30\"}]}, {\"day_number\": 4, \"date\": \"2026-08-19\", \"weekday_en\": \"Wednesday\", \"weekday_ml\": \"ബുധനാഴ്ച\", \"nakshatra\": \"Vishakham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 3, \"kollam_year\": 1202, \"captions\": [\"Vishakham Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Vishakham\", \"begin\": \"2026-08-19T06:47:04+05:30\", \"end\": \"2026-08-20T09:08:29+05:30\"}]}, {\"day_number\": 5, \"date\": \"2026-08-20\", \"weekday_en\": \"Thursday\", \"weekday_ml\": \"വ്യാഴാഴ്ച\", \"nakshatra\": \"Vishakham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 4, \"kollam_year\": 1202, \"captions\": [], \"is_repeat_day\": true, \"segments\": [{\"name\": \"Vishakham\", \"begin\": null, \"end\": null}]}, {\"day_number\": 6, \"date\": \"2026-08-21\", \"weekday_en\": \"Friday\", \"weekday_ml\": \"വെള്ളിയാഴ്ച\", \"nakshatra\": \"Anizham\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 5, \"kollam_year\": 1202, \"captions\": [\"Anizham Day\", \"Vallam Kali\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Anizham\", \"begin\": \"2026-08-20T09:08:29+05:30\", \"end\": \"2026-08-21T11:53:15+05:30\"}]}, {\"day_number\": 7, \"date\": \"2026-08-22\", \"weekday_en\": \"Saturday\", \"weekday_ml\": \"ശനിയാഴ്ച\", \"nakshatra\": \"Thrikketta\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 6, \"kollam_year\": 1202, \"captions\": [\"Thriketa Day\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Thrikketta\", \"begin\": \"2026-08-21T11:53:15+05:30\", \"end\": \"2026-08-22T14:49:28+05:30\"}]}, {\"day_number\": 8, \"date\": \"2026-08-23\", \"weekday_en\": \"Sunday\", \"weekday_ml\": \"ഞായറാഴ്ച\", \"nakshatra\": \"Moolam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 7, \"kollam_year\": 1202, \"captions\": [\"Moolam Day, Onam Sadya\", \"Puli Kali, Kaikotti Kali\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Moolam\", \"begin\": \"2026-08-22T14:49:28+05:30\", \"end\": \"2026-08-23T17:44:53+05:30\"}]}, {\"day_number\": 9, \"date\": \"2026-08-24\", \"weekday_en\": \"Monday\", \"weekday_ml\": \"തിങ്കളാഴ്ച\", \"nakshatra\": \"Pooradam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 8, \"kollam_year\": 1202, \"captions\": [\"Pooradam Day, Onathappan\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Pooradam\", \"begin\": \"2026-08-23T17:44:53+05:30\", \"end\": \"2026-08-24T20:28:27+05:30\"}]}, {\"day_number\": 10, \"date\": \"2026-08-25\", \"weekday_en\": \"Tuesday\", \"weekday_ml\": \"ചൊവ്വാഴ്ച\", \"nakshatra\": \"Uthradam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 9, \"kollam_year\": 1202, \"captions\": [\"Uthradom Day, First Onam\", \"Uthradappachil\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Uthradam\", \"begin\": \"2026-08-24T20:28:27+05:30\", \"end\": \"2026-08-25T22:51:30+05:30\"}]}, {\"day_number\": 11, \"date\": \"2026-08-26\", \"weekday_en\": \"Wednesday\", \"weekday_ml\": \"ബുധനാഴ്ച\", \"nakshatra\": \"Thiruvonam\", \"malayalam_month\": \"Chingam\", \"malayalam_day\": 10, \"kollam_year\": 1202, \"captions\": [\"Thiruvonam Day, Second Onam\", \"Thiru-Onam, Onam\"], \"is_repeat_day\": false, \"segments\": [{\"name\": \"Thiruvonam\", \"begin\": \"2026-08-25T22:51:30+05:30\", \"end\": \"2026-08-27T00:48:15+05:3"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।